Update Workflow Approval Status

Update the approval status of a workflow run’s output.

Request Body:

• action: One of “approve”, “reject”, or “pending”
• notes: Optional notes about the decision

Approval Flow:

• When approved, the workflow output will be applied to the data asset
• When rejected, the workflow output is discarded
• When set to pending, the approval is reset for re-review (clears previous decision)

Returns:

• 200: Approval updated successfully
• 400: Invalid action (e.g., trying to set to pending when already pending)
• 404: Approval not found for this run

PATCH /api/data-readiness/workflows/runs/{run_id}/approval

Update Workflow Approval Status

cURL

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>"
}
'

200

{
  "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

200

application/json

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

Details of changes applied to the data asset