Update Workflow Approval Status

curl --request PATCH \ --url https://api.example.com/api/data-readiness/workflows/runs/{run_id}/approval \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "action": "<string>", "notes": "<string>" } '

{ "id": "<string>", "workflow_run_id": "<string>", "status": "<string>", "created_at": "<string>", "updated_at": "<string>", "approved_by_client_id": "<string>", "approved_at": "<string>", "notes": "<string>", "auto_saved": false, "changes_applied": {} }

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.

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

Details of changes applied to the data asset