Skip to main content
DELETE
/
v1
/
uploads
/
{uploadId}
Delete an upload and its associated file
curl --request DELETE \
  --url https://api.example.com/v1/uploads/{uploadId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true
}

Authorizations

​
Authorization
string
header
required

Clerk session JWT or Unkey API key passed as Bearer token

Headers

​
x-adclear-workspace-id
string<uuid>

Workspace ID fallback. Required when authenticating with a Bearer token in environments where cookies cannot be shared (e.g. preview). Not needed for API key auth (workspace is embedded in the key metadata) or when the workspace cookie is present.

Example:

"43dc2a1c-3384-41b5-a6e9-3b2d607d0fae"

​
x-external-user-id
string

Required when authenticating with an API key. Identifies the end-user making the request. Ignored when authenticating with a Bearer token (the user ID is extracted from the token).

Example:

"user_abc123"

​
x-external-user-email
string<email>

Optional. Email of the external user, used for audit logging. Only applicable when authenticating with an API key.

Example:

"user@example.com"

Path Parameters

​
uploadId
string<uuid>
required

Upload ID

Response

Upload and file deleted

​
success
boolean
required