Workflows

Comment on one task

Adds a comment to a single STEP’s thread, distinct from workflow_comment which posts to the whole run’s thread. May tag colleagues by id — each is notified — but only people who can already open this run; tagging anybody else is refused rather than silently dropped. Use this for a note about one approver’s decision; use workflow_comment for something about the run as a whole.

post/api/v1/rest/workflow/tasks/{id}/comments

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/workflow/tasks/{id}/comments
  • Auth: HTTP bearer

Path parameters

idstring uuid required

From workflow_list_tasks.

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Request body

bodystring required
mentionsstring[]

Member ids to tag — only people already able to open this run.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.