# Delete an upload

URL: https://www.atmee.ai/docs/api/reference/avatars/deleteUpload

`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.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `uploadId` | path | yes |  |

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `204` | The upload is ended. | none |
| `401` | Missing or invalid API key, or a user token that is invalid, anonymous or of a user who may act for no account (`invalid_login`). | none |
| `403` | insufficient_scope \| account_not_allowed (`X-Account-Id` names an account the user may not act for) | `ApiErrorResponse` |
| `404` | upload_not_found | `ApiErrorResponse` |
| `409` | upload_consumed \| account_ambiguous (a user of several accounts sent no `X-Account-Id`) | `ApiErrorResponse` |
| `503` | upload_unavailable -- this instance has no upload store. | `ApiErrorResponse` |
