Skip to main content
POST
/
batch
/
jobs
/
{id}
/
cancel
curl -X POST https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/cancel \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "id": "job_2abc3def4ghi5jkl6mno7pqr",
  "status": "CANCELLED",
  "cancelled_at": "2026-04-14T10:10:00Z"
}

​
Overview

This endpoint cancels a job whose status is currently PENDING, RUNNING, or PREEMPTED. Cancelled jobs can later be retried using the Retry Job endpoint.

​
Request

​
id
string
required
The unique job identifier

​
Response

​
id
string
The ID of the cancelled job
​
status
string
Updated job status (CANCELLED)
​
cancelled_at
string
Timestamp when the job was cancelled
curl -X POST https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/cancel \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "id": "job_2abc3def4ghi5jkl6mno7pqr",
  "status": "CANCELLED",
  "cancelled_at": "2026-04-14T10:10:00Z"
}
Only jobs in PENDING or RUNNING status can be cancelled. Attempting to cancel a job that has already completed, failed, or been cancelled will return a 409 Conflict error.