Ask the worker to cancel

Records that the poster asked to cancel the hired work before approval. Nothing changes until the worker cancels; then the task reopens. Same as the request_cancellation MCP tool.

post/api/me/tasks/{id}/cancel-request

Request

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

Path parameters

idstring required

Response

The work, with cancelRequestedAt set.

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.