List pending approvals
GET /api/v1/approvals
Returns all actions awaiting human approval for the authenticated tenant, ordered by creation time.
Authorizations
Parameters
Query Parameters
Maximum number of approvals to return
Maximum number of approvals to return
Number of approvals to skip
Number of approvals to skip
Responses
200
Successful Response
Envelope response for the approval list endpoint.
Attributes: data: The approval list payload. meta: Standard response metadata.
object
Inner data payload for the approval list response.
Attributes: approvals: List of pending approval items. total: Total number of pending approvals.
object
A single pending approval in the queue.
Attributes: id: Unique identifier for this approval item. agent_role: The agent that requested the action. action_type: Machine-readable action identifier. description: Human-readable description of the proposed action. reasoning: Why the engine decided this needs approval. urgency: How time-sensitive this approval is. estimated_impact: Estimated business impact of the action. created_at: When this item was added to the queue. source: Origin queue (“decision” | “workflow_gate”). workflow_run_id: Workflow run UUID when source is workflow_gate.
object
Standard metadata included in every API response.
Attributes: request_id: Unique identifier for this request. timestamp: When the response was generated.
object
Unique identifier for this request
When the response was generated
422
Validation Error