Skip to main content
POST
Upload a small file (≤ 10 MB)

Authorizations

Authorization
string
header
required

Identify accepts a workspace API key (sk_…). Loom accepts either a short-lived session token (direct) or a workspace API key (relay).

Headers

Idempotency-Key
string

Makes this POST safe to retry. The first call does the work and its response is stored; a retry with the same key returns that stored response with Idempotency-Replayed: true, without charging again. Same key with a different body is rejected. Keys expire after 24 hours.

Maximum string length: 255

Body

file
file
required
media_type
string
filename
string

Response

Stored. Returns a ready file handle.

status
string
required
Allowed value: "success"
data
object
required

A stored file. sha256 and size are present once state is ready. While state is uploading, segment_size and received_segments describe the resumable session.