Skip to main content
POST
Upload file

Authorizations

Authorization
string
header
required

A workspace API token created in AI → API & SDK. This is not an MCP token.

Headers

Idempotency-Key
string
required
Required string length: 16 - 128

Path Parameters

workspace
string
required
Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
Example:

"01M6TF7X1MD67JKPT1BRPZSAJ6"

Body

multipart/form-data
file
file
required
parent
string | null
Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
Example:

"01M6TF7X1MD67JKPT1BRPZSAJ6"

Response

Successful response.

id
string
required
Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
Example:

"01M6TF7X1MD67JKPT1BRPZSAJ6"

kind
enum<string>
required
Available options:
file,
folder
name
string
required
revision
integer
required
Required range: x >= 1
size
integer
Required range: x >= 0
mediaType
string
width
integer | null
height
integer | null
versionId
string | null
Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
Example:

"01M6TF7X1MD67JKPT1BRPZSAJ6"

thumbnailUrl
string | null
previewUrl
string | null