Skip to main content
POST
Create a governed portfolio submission
This route stages evidence only. Upload the media with the returned signed PUT URL, then call upload completion. The partner credential never writes directly to Sanity.

Authorizations

X-API-Key
string
header
required

WorkOS organization API key mapped to a TattooAPI service actor.

Body

application/json
idempotencyKey
string
required
Minimum string length: 8
tenantId
string
required
artistCanonicalId
string
required
source
enum<string>
required
Available options:
permanent_imessage,
partner_api,
operator_upload
fileName
string
required
mimeType
enum<string>
required
Available options:
image/jpeg,
image/png,
image/webp,
image/heic
sizeBytes
integer
required
Required range: x >= 1
rightsPosture
enum<string>
required
Available options:
owner_attested,
artist_attested,
review_required
Available options:
client_consented,
not_required,
review_required
studioCanonicalId
string
sourceMessageId
string
title
string
description
string
styleIds
string[]
placement
string
tags
string[]

Response

Submission created

success
boolean
data
object