Terminate a tus upload

Terminates an unfinished resumable upload and releases its stored data. Completed uploads cannot be terminated; the server returns HTTP 400.

DELETE{UPLOAD_URL}

Note

Use the upload capability URL from the Location header of the successful create-upload response. It does not use ambient API2 host credentials.

Request example

Set UPLOAD_URL to the complete Location URL returned when creating the tus upload. Keep this URL secret.

curl --fail-with-body -sS --request DELETE --include \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --header 'tus-resumable: 1.0.0'

Request headers

Complete JSON Schema

Open JSON in a new tab

Normalized lowercase headers for a canonical tus DELETE request.

Fields beyond those listed for this object are accepted.

Field	Type and description
`tus-resumable` required	`string` (always: "1.0.0") The negotiated tus version.

Response

HTTP 204

No response body.

Response headers

Complete JSON Schema

Open JSON in a new tab

Fields beyond those listed for this object are accepted.

Field	Type and description
`tus-resumable` required	`string` (always: "1.0.0")
`x-content-type-options` required	`string` (always: "nosniff")

Error response

Text response body. text/plain; charset=utf-8

Response body schema

Complete JSON Schema

Open JSON in a new tab

string

Any of the following schemas may apply:

Variant 1: string

string

Validation pattern (regular expression)

^ERR_[A-Z0-9_]+: [^\r\n]*\n$

Variant 2: string

string

Raw text/plain hook error framing with a verbatim payload; JSON-shaped but not necessarily valid JSON.

Validation pattern (regular expression)

^\{"error":"(?:[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]|[^\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff])*"\}$

Response headers

Complete JSON Schema

Open JSON in a new tab

Fields beyond those listed for this object are accepted.

Field	Type and description
`content-type` required	`string` (always: "text/plain; charset=utf-8")
`tus-resumable` required	`string` (always: "1.0.0")
`x-content-type-options` required	`string` (always: "nosniff")