Cancel an upload
/uploads/{upload_id}Cancels an open upload session. Set status to cancelled; no other change is supported.
Sessions that are already completed, cancelled, failed, or expired cannot be cancelled and return state_conflict. To remove a file produced by a completed upload, use the delete file operation.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/uploads/string" \ -H "Content-Type: application/json" \ -d '{ "status": "cancelled" }'{ "data": { "expires_at": "2019-08-24T14:15:22Z", "failure_reason": "string", "file": { "checksum": { "md5": "string", "sha256": "string" }, "content_type": "string", "created_at": "2019-08-24T14:15:22Z", "extension": "string", "filename": "string", "id": "string", "object": "file", "purpose": "string", "size_bytes": 0, "status": "ready" }, "filename": "string", "id": "string", "object": "upload", "part_size": 0, "parts_total": 0, "purpose": "string", "size_bytes": 0, "status": "open" }}Retrieve an upload GET
Retrieves an upload session by its public ID, including its current status and expiration time. When the session is `completed`, the response includes the resulting `file`. To see which parts the storage service has already received, use the list upload parts operation.
Complete an upload POST
Completes a multipart upload after all parts have been sent to the storage service. Provide every part number together with the `ETag` returned by the storage service for that part. The storage service verifies the integrity of the assembled content. On success, the session moves to `completed` and the response includes the resulting `file`. If the content does not match the declared size, checksum, or content type, the API returns `upload_integrity_mismatch` with the exact cause in `details[].reason`. The session is then permanently marked as `failed`, and a new upload session is required.