ReferenceAPI reference
Approvals
2 operations in the Approvals group.
POST /api/resources/{workspace}/workflow-runs/{workflowRun}/approvals/{nodeKey}
Operation ID: decideManagedApproval
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
workspace | path | yes | string | |
workflowRun | path | yes | string | |
nodeKey | path | yes | string |
Request body — application/json · WorkflowApprovalDecisionRequest (required)
| Field | Type | Required |
|---|---|---|
approved | boolean | no |
decision | enum(approve, deny, reject, request_changes) | no |
message | `string | null` |
proposal_key | `string | null` |
expected_action_digest | `string | null` |
expected_proposal_digest | `string | null` |
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | Approval decision applied; returns the updated workflow run. | WorkflowRunResponse |
| 403 | Reviewer is not authorized by approval policy. | — |
| 409 | Approval digest is stale or reviewer already approved. | — |
| 422 | Approval request is invalid for the current gate state. | — |
GET /api/resources/{workspace}/workflow-runs/{workflowRun}/gates
Operation ID: listWorkflowRunGates
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
workspace | path | yes | string | |
workflowRun | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | Human approval gates on a workflow run. | WorkflowRunGateCollectionResponse |