Workflows

Claim an unclaimed task

Takes a role-routed task off the shared queue and assigns it to the caller, so only they (or an admin) may decide it afterwards. Refuses a task already claimed by somebody else, and one that has already been decided. Call workflow_list_tasks first to find a task worth claiming.

Examples

  • Take that approval for myself before someone else does POST /api/v1/rest/workflow/tasks/44444444-5555-4666-8777-888888888888/claim
post/api/v1/rest/workflow/tasks/{id}/claim

Request

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

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.