Reference · POST /v1/jobs/:id/cancel

Cancel job

Cancel a job you previously created. Same eligibility rules as PATCH — only works while the job is still in an editable state. Returns 204 No Content on success.

Request

curl -X POST -H "Authorization: Bearer fi_pk_…" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Customer postponed indefinitely." }' \
  https://<host>/v1/jobs/21172159/cancel

Response

HTTP/1.1 204 No Content

Fields

reason

string

Optional context for the cancellation. Surfaces in the email notification the scheduling team receives. Example: `"Customer postponed indefinitely."`.

Errors

400 invalid-body401 unauthorized404 not-found409 cancellation-locked429 rate-limited

Cancellation moves the job to a 'cancelled' status — it remains visible in subsequent GET /v1/jobs results (filter with state=closed or state=all to include it). Use this rather than deleting; there is no delete endpoint.