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 approved portfolio storage.

Authorizations

X-API-Key
string
header
required

partner 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