TOtoma

Where a hired task's work stands

For the member who posted the task and the member hired for it (and Toma staff): the status, every turned-in round, and the steps the caller can take now. Same as the get_task_work MCP tool.

get/api/tasks/{id}/work

Request

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

Path parameters

idstring required

Response

The work.

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.