Skip to main content
POST
Upload a file

Authorizations

X-API-Key
string
header
required

API Key (starts with ak_...)

Body

multipart/form-data
file
file
required

file (max 50 MB)

Response

201 - application/json

File uploaded successfully

id
string
required

File ID

Example:

"550e8400-e29b-41d4-a716-446655440000"

filename
string
required

Original filename

Example:

"document.pdf"

mimeType
string
required

MIME type

Example:

"application/pdf"

sizeBytes
number
required

File size in bytes

Example:

102400

kind
enum<string>
required

File kind (input or output)

Available options:
INPUT,
OUTPUT
Example:

"INPUT"

sourceAction
object | null
required

Source action (null for uploads, action name for outputs)

Example:

null

expiresAt
string<date-time>
required

Expiration timestamp

createdAt
string<date-time>
required

Upload timestamp