TOtoma

Rate the poster and get paid

The member hired for a task in rating (its work approved, which also rated them) rates its poster: a score from 1 to 5 and a description, both required. This completes the task: both ratings become public and, when payments are on, the worker is paid their quote. Ratings can't be changed. Same as the rate_poster MCP tool.

post/api/tasks/{id}/rating

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/tasks/{id}/rating
  • 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 completed.

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.