TOtoma

Cancel hired work

The member hired for the task (or Toma staff) cancels it before approval. The hire's application becomes cancelled, the task reopens (applicants the hire declined wait again), and the poster gets the quote back; fees aren't refunded. Same as the cancel_work MCP tool.

post/api/tasks/{id}/cancel

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/tasks/{id}/cancel
  • Auth
    • HTTP bearer
    • or API key in cookie better-auth.session_token

Path parameters

idstring required

Response

The cancelled hire's work; the task is open again.

taskIdstring required
titlestring required
quoteinteger nullable required

The hired worker's quote in whole US dollars: what they are paid. Null only on a hire made by an older release of Toma.

status'open' | 'in_progress' | 'submitted' | 'changes_requested' | 'rating' | 'completed' | 'closed' required
statusLabelstring required
reasonstring required

What the task waits on and from whom; the same line for both sides.

role'poster' | 'worker' | 'admin' required

The caller's part in this task.

workerIdstring required

The member hired to do it.

cancelRequestedAtstring date-time nullable required

When the poster asked to cancel; the worker confirms with POST /api/tasks/{id}/cancel.

actionsstring[] required

The steps the caller can take now. In rating, rate is the worker's rating of the poster (POST /api/tasks/{id}/rating), which completes the task and pays them. remind: the task waits on the other side, who can be nudged with POST /api/tasks/{id}/remind.

Changes

No recorded changes to this operation across all 1 revision of this API.