Skip to main content
POST
/
api
/
data-readiness
/
workflows
/
runs
/
{run_id}
/
approval
Create Pending Approval
curl --request POST \
  --url https://api.example.com/api/data-readiness/workflows/runs/{run_id}/approval \
  --header 'Authorization: Bearer <token>'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Response

Successful Response

Response for workflow run approval operations.

​
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)