Workflows

Approve, reject or return a task

Records a decision on a task in YOUR inbox. This is an act with consequences for other people — it advances or stops a run, and an approval may release a payment. ALWAYS show the user what they are approving and get an explicit yes first. You may only decide a task assigned to you, to your role, or delegated to you. returned sends the run back a stage for correction.

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

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/workflow/tasks/{id}/decision
  • 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

outcome'approved' | 'rejected' | 'returned' required

returned sends the run back a stage for correction rather than killing it.

fieldsobject

Values for the task’s own decision fields, if it declares any.

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.