Discard an unfinished upload: aborts its open sessions and settles the batch as failed (`UPLOAD_BATCH_DISCARDED`). 409 UPLOAD_BATCH_ACTIVE while the uploader is alive; 409 UPLOAD_BATCH_NOT_DISCARDABLE when a file already completed or the batch was submitted.
POST
/v1/upload-batches/{batchId}/cancellation-requestscurl -X POST 'https://api.embodiflow.io/v1/upload-batches/{batchId}/cancellation-requests' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Path parameters
- batchIdstringrequired
Header parameters
- Idempotency-Keystring
Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.
Responses
Success
- dataobjectrequired
- statusstringrequiredAllowed valuesfailed
- abortedSessionsnumberrequired
Response example
{
"data": {
"status": "failed",
"abortedSessions": 0
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1