API reference

Upload a task attachment

Uploads bytes for a later task or message. The returned upload id is opaque, expires after 24 hours, and creates no durable file until referenced.

POST/v1/uploads

Authorization

Send a personal API key or an OAuth access token as Authorization: Bearer <token>.

OAuth scopes: files:write

multipart/form-data, required

201Success

400Invalid request

401Missing or invalid Bearer credential

402Payment or subscription required

403Credential is missing a required scope

404Resource not found

409Request conflict

429Rate limit exceeded

500Internal API error

curl --request POST \
  --url 'https://api.staging.adam.new/v1/uploads' \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@./part.step'

{
  "upload": {
    "id": "<string>",
    "name": "<string>",
    "mediaType": "<string>",
    "size": 123,
    "expiresAt": "<string>"
  }
}