Skip to main content
POST
Review task

Authorizations

api-key
string
header
required
api-sign
string
header
required
api-nonce
string
header
required

Path Parameters

task_id
string
required

Task identifier, an approval UUID (UUID v4). T-prefixed identifiers are not accepted or returned. Responses always emit lowercase. Requests accept any letter case.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json
type
string
required

The review decision to record. Must be either approve or deny.

Example:

"approve"

comment
string

Optional free-text comment to attach to the decision. Surfaced in the task's activity timeline.

Example:

"Transaction approved by finance team"

Response

The task's lifecycle state after the decision was applied.

state
string
required

New lifecycle state of the task after the decision was applied. One of pending, approved, rejected, canceled, expired, failed, executed.

Example:

"approved"