Workflows

Delegate my approvals to a colleague

Grants an active colleague the right to see and act on the caller’s work — an out-of-office backup. modules says WHICH work, and the four scopes do not overlap: workflow is every approval run EXCEPT expense claims, spese is the nota spese approvals, attivita is the caller’s own tasks, timbratura is the leave and correction requests of the caller’s team. Omitting it delegates the two approval scopes, which is what a delegation meant before the scopes existed. Requires the workflow.delegations feature. Leave the dates open for an immediate, indefinite delegation, or bound it to the trip you are actually taking.

post/api/v1/rest/workflow/delegations

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/workflow/delegations
  • Auth: HTTP bearer

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

delegate_userstring uuid required

An active member of this tenant, not the caller.

modulesstring[]

Which work the backup inherits. Defaults to the two approval scopes (workflow, spese). Add attivita to hand over the caller’s tasks too.

starts_atstring date-time nullable

Today or later — a delegation cannot be backdated.

ends_atstring date-time nullable

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.