Skip to content
SpatialGen API

Cancel Upload Group

DELETE /api/videos/uploads/{uploadSessionId}

Cancel the full direct upload group. This endpoint does not cancel one file at a time. All active files in the group are marked canceled together.

Allowed API Key Roles

adminupload

Route Parameters

  • uploadSessionId: string UUID for the upload group

Request Body

No request body.

Behavior Notes

  • Cancels the entire upload group.
  • Attempts to abort any active multipart uploads in the group.
  • Marks every file in the group as canceled.
  • Recomputes the group state so the upload group is also marked canceled.

Response Shape

  • sessionId: string
  • status: string
  • canceledAt: string or null
  • fileCount: number
  • canceledFileCount: number

Example Request

cancel-upload.js
fetch('https://spatialgen.com/api/videos/uploads/5ea97a59-95e0-4c8b-a634-b0fa9976f6ff', {
  method: 'DELETE',
  headers: {
    'X-SPATIALGEN-APPKEY': apiKey,
  },
})

Example Response

cancel-response.json
{
  "sessionId": "5ea97a59-95e0-4c8b-a634-b0fa9976f6ff",
  "status": "canceled",
  "canceledAt": "2026-04-29T19:02:14.000Z",
  "fileCount": 5,
  "canceledFileCount": 5
}