Atmee.aiDocs
APIAPI referenceAvatars

Delete an upload

DELETE
/v1/uploads/{uploadId}

Ends an upload you no longer need (pending or uploaded), so it stops counting toward the account's 100 unused uploads; it then reads as expired. Deleting one that already ended answers 204 again. One a create or replace used cannot be deleted (409 upload_consumed).

A generation output (a clip, a portrait or a voice preview the generation routes returned) can be deleted too, whatever its status, a used one included: its file is deleted at once, so its url stops working (GET /v1/files/{uploadId} answers 410) and it can no longer be passed as upload:<uploadId>.

Scopes: avatars:write deletes any upload; generation:write deletes portrait, voice and clip uploads.

Authorization

headerX-Api-Key<token>

Your secret API key (sk_atmee_...; older keys start sk_live_), sent as X-Api-Key. Keep it on your server and never send it to a browser.

Path Parameters

uploadId*string
Formatuuid

Response Body

The upload is ended.

Example Request
curl -X DELETE 'https://api.atmanity.us/v1/uploads/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
Empty