Skip to main content
POST
Mint a presigned upload session

Authorizations

x-api-key
string
header
required

Org-issued integration API key (service account credential). The plaintext secret is shown once at creation.

Headers

X-Idempotency-Key
string
required

Stable caller-chosen key (max 200 chars) making the mutation safely retryable.

Maximum string length: 200
If-Match
string
required

Current entity revision, quoted (e.g. "3"), from the last ETag.

Body

application/json
operation
string
required
Allowed value: "create"
caseId
string
required
Required string length: 1 - 200
name
string
required
Required string length: 1 - 255
mimeType
string
required
Required string length: 1 - 255
sizeBytes
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
sha256
string
required
Pattern: ^[A-Za-z0-9+/]{43}=$
folderId
string | null
Required string length: 1 - 200

Response

{ success: true, upload: { id, url, ... } }

success
boolean
required
{key}
any