Cancel a batch | Respan Docs

curl -X POST https://api.respan.ai/api/v1/batches/batch_abc123/cancel \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "batch_abc123",
  "status": "cancelling",
  "object": "batch",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file-abc123",
  "output_file_id": "file-output456",
  "error_file_id": "file-error789",
  "completion_window": "24h",
  "created_at": 1710000000,
  "in_progress_at": 1710003600,
  "expires_at": 1710086400,
  "finalizing_at": 1710007200,
  "completed_at": 0,
  "failed_at": 0,
  "expired_at": 0,
  "cancelling_at": 1710010800,
  "cancelled_at": 0,
  "request_counts": {
    "total": 100,
    "completed": 97,
    "failed": 3
  },
  "metadata": {},
  "errors": null
}

Cancel an in-progress OpenAI-compatible batch. Already completed requests are not affected.

Path parameters

batch_idstringRequired

Batch ID.

Request

This endpoint expects an object.

Response

Batch cancellation initiated.

idstring

Batch ID.

statusenum

objectstring

endpointstring

input_file_idstring

output_file_idstring or null

Output file ID, available when the batch completes.

error_file_idstring or null

Error file ID, when provider errors are available.

completion_windowstring

created_atinteger

Unix timestamp.

in_progress_atinteger or null

expires_atinteger or null

finalizing_atinteger or null

completed_atinteger or null

failed_atinteger or null

expired_atinteger or null

cancelling_atinteger or null

cancelled_atinteger or null

request_countsobject

metadatamap from strings to any

errorsany or null

Provider error details, when available.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

Path parameters

Headers

Request

Response

Errors