network.cancelBooking
Cancel a booked customer job (owner or office). The customer's deposit is refunded in full automatically, including Doing Work's fee. Only the deposit is refunded; anything else the customer paid on the invoice is the shop's to refund with invoices.refund. Moves money: a no_money key cannot call it, a worker needs take_money, and an agent cancel above the shop's agent refund cap waits for the owner.
| Who | Agents can call this |
| REST | POST /v1/network/cancel |
| MCP tool | network_cancelBooking |
| Writes | yes, send an Idempotency-Key |
| Area | Shop |
When to use it
Cancel a booked customer job (owner or office). The customer's deposit is refunded in full automatically, including Doing Work's fee.
What to tell the owner
Say what you did in plain words and what happens next.
Input
| Field | Type | Required |
|---|---|---|
shop_id | string (uuid) | yes |
job_id | string (uuid) | yes |
reason | string | no |
Example
POST https://doingwork.work/v1/network/cancel
content-type: application/json
Idempotency-Key: 3f1c...
{
"shop_id": "00000000-0000-4000-8000-000000000000",
"job_id": "00000000-0000-4000-8000-000000000000"
}Output
JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.
Errors
| Code | Status | What to do |
|---|---|---|
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |