Cancel Job

Cancel a pending or queued job.

Detail Specification
Method POST
URI /v3/jobs/{jobId}/cancel
Security JWT Bearer Token
Success Response 200 OK

Path Parameters

Parameter Type Required Description
jobId String Yes The job ID

Example Request

curl -X POST /v3/jobs//cancel \
  -H "Authorization: Bearer "

Success Response (200)

{
  "success": true,
  "job": {
    "jobId": "job-uuid-abc",
    "status": "CANCELLED",
    "cancelledAt": "2024-01-14T16:00:00Z"
  }
}

Error Responses

Status Error Description
404 Job not found The specified job ID does not exist
400 Cannot cancel job Job is not in a cancellable state

Notes

  • Only jobs with status PENDING or QUEUED can be cancelled
  • Jobs that are IN_PROGRESS, COMPLETED, FAILED, or already CANCELLED cannot be cancelled

IDI Integration API Documentation © 2025