Batches
Cancel a Batch
Cancel processing of a Batch. Unstarted tasks will be cancelled. Completed batches cannot be cancelled.
POST
Authentication
Authentication
Every request sent to Scale’s API requires authentication. In short, your API Key is the Bearer token. See the Authentication section for more details.
Batch Status Requirements
You can cancel batches in any status except completed or cancelled (already cancelled).
Once cancelled, the batch status will change to cancelled and all unstarted tasks will be cancelled. Cancelled batches cannot be resumed.
Required request parameters
You are expected to provide one of the following in the request body:
- Batch ID (
batch_id
) - Batch Name (
batch_name
)
Authorizations
Your API Key is the Bearer token. See the Authentication section to learn how to access your key.
Body
application/json
Response
200
application/json
Batch cancellation initiated successfully.
The response is of type object
.