TOtoma

Approve turned-in work

Moves the task from submitted to rating and rates the worker: score (1 to 5) and description are required, stay private until the worker rates back, and can't be changed. Nothing is paid yet: the worker's rating of the poster (POST /api/tasks/{id}/rating) completes the task and pays them. Same as the approve_work MCP tool.

post/api/me/tasks/{id}/approve

Request

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

Path parameters

idstring required

Request body

scoreinteger required
descriptionstring required

Response

The work, now approved and in rating.

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.