Cancel a job before delivery. The buyer pays $0.

`cancel_job`

POST /jobs/{id}/cancel

Parameters

idstring · in pathrequired

The job, as every answer names it.

Services-Versionstring · in header

Idempotency-Keystring · in header

Returns

Request

$ npx services.dev cancel job_7Hq8
job_7Hq8 · canceled · buyer · $0

curl -X POST http://localhost:8787/jobs/job_7Hq8/cancel

→ tools/call cancel_job {"id":"job_7Hq8"}
← job_7Hq8 · canceled · buyer · $0

await job.cancel()

Response

{
  "id": "job_7Hq8",
  "object": "job",
  "created": "2026-10-25T14:02:11.000Z",
  "livemode": false,
  "simulated": true,
  "service": "translation",
  "input": {
    "document": {
      "url": "https://example.com/contract.pdf",
      "name": "contract.pdf"
    },
    "to": "it"
  },
  "metadata": {},
  "price": {
    "usd": 49,
    "approved": false,
    "max_usd": 49
  },
  "payment": {
    "status": "none",
    "amount_usd": 0
  },
  "human": "AI delivers every job.",
  "stage": null,
  "steps": [
    {
      "id": "stp_1",
      "object": "step",
      "step": "draft",
      "by": "ai",
      "status": "pending"
    },
    {
      "id": "stp_2",
      "object": "step",
      "step": "review",
      "by": "ai",
      "review": "adversarial",
      "status": "pending"
    }
  ],
  "next": [],
  "status": "canceled",
  "reason": "buyer"
}

job_7Hq8 · canceled · buyer · $0

captured at build · dev() seed 7Hq2 · services.dev 0.3.0