Upload status
GET
pending until the file arrives, then uploaded (usable once), consumed
once a create or replace used it, or expired an hour after it was
created. Only the account that created it sees it. Requires
avatars:read or avatars:write.
header
X-Api-Key<token>Secret embed API key (sk_atmee_...; keys minted before 2026-09
carry sk_live_...), held by the customer's own backend and never
sent to a browser. Format: X-Api-Key: sk_atmee_....
uploadId*stringFormat
uuidThe upload.
application/json- response
uploadId*stringFormat
uuidkind*UploadKindValue in
"portrait""voice""knowledge"status*stringValue in
"pending""uploaded""consumed""expired"size?integerBytes received, once uploaded.
Format
int64contentType?stringThe declared type, then the type the file was sent with.
fileName?stringexpiresAt*stringFormat
date-timecurl -X GET 'https://api.atmanity.us/v1/uploads/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
{ "uploadId": "ef523ba8-509e-47af-8e2c-5fa751596497", "kind": "portrait", "status": "pending", "size": 0, "contentType": "string", "fileName": "string", "expiresAt": "2019-08-24T14:15:22Z"}