Remind the other side

Either side of a hired task nudges the other when the task waits on them and not on the caller: the worker to turn in the work or the requested changes, the poster to review it, or either side to rate. Offered only when the caller's work actions include remind. The other side gets a notification saying what the task waits on; nothing about the task changes. At most 3 reminders per task per hour from each side. Same as the remind_about_work MCP tool.

post/api/tasks/{id}/remind

Request

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

Path parameters

idstring required

Response

The task's work, unchanged.

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.