Skip to main content
DELETE
Permission Required: project:manage-build-storage
Cancel an in-progress upload. This is especially useful for multipart uploads where you want to abort before completion.

Query Parameters

build_id
string
required
Build ID to cancel
object_key
string
required
Object key from initiate upload response
upload_id
string
Upload ID (required for multipart uploads)

Response

success
boolean
required
Always true on successful cancellation

When to Use

Abort Failed Upload

Cancel a stuck or failed upload immediately

Reclaim Storage

Free up reserved storage capacity before timeout

Automatic Cleanup

Uploads have a configurable timeout (default: 10 minutes for single-part, 60 minutes for multipart). After timeout:
  • Reserved storage capacity is reclaimed
  • Incomplete uploads are marked for cleanup
  • Partially uploaded parts are removed
You can set a custom timeout when initiating the upload with the upload_timeout field (1-1440 minutes).

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

projectId
string
required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

Query Parameters

build_id
string
required

Build ID to cancel

object_key
string
required

Object key for the upload

upload_id
string

Upload ID (required for multipart uploads)

Response

Upload cancelled successfully

success
boolean