Skip to main content
PATCH
Update Workflow Approval Status

Authorizations

Authorization
string
header
required

JWT Bearer token authentication. Include the token in the Authorization header as: Authorization: Bearer <token>. The JWT must contain valid client_id, and project_id claims for tenant isolation and SDK routing.

Path Parameters

run_id
string
required

Workflow run ID

Body

application/json

Request body for approving, rejecting, or resetting a workflow run approval.

action
string
required

Approval action to take

Pattern: ^(approve|reject|pending)$
Examples:

"approve"

"reject"

"pending"

notes
string | null

Optional notes about the approval decision

Maximum string length: 2000

Response

Successful Response

Approval response with information about applied changes.

id
string
required

Unique approval identifier

workflow_run_id
string
required

Workflow run ID

status
string
required

Approval status

Examples:

"pending"

"approved"

"rejected"

created_at
string
required

Creation timestamp (ISO 8601)

updated_at
string
required

Last update timestamp (ISO 8601)

approved_by_client_id
string | null

Client ID of approver

approved_at
string | null

Approval timestamp (ISO 8601)

notes
string | null

Approval notes

auto_saved
boolean
default:false

Whether this approval was auto-saved (no manual approval step)

changes_applied
Changes Applied · object | null

Details of changes applied to the data asset