Get Approval

Database and access

These endpoints use the AgentOS-level database. Configure AgentOS(db=...) with an adapter that implements approvals; unsupported approval operations return 503. See Approvals.

Scoped callers can read only requester-owned records. Non-admin JWT callers are scoped with user isolation enabled; non-admin service-account PAT callers are scoped even without it. A caller-supplied user_id does not override this identity.

An inaccessible scoped record returns 404. Its approval status and expiry timestamp describe the stored record; they are not a live run-status response.

GET/approvals/{approval_id}

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

approval_id*Approval Id

Response Body

application/json

application/json

curl --request GET 'https://example.com/approvals/string'
{  "id": "string",  "run_id": "string",  "session_id": "string",  "status": "string",  "source_type": "string",  "approval_type": "string",  "pause_type": "string",  "tool_name": "string",  "tool_args": {},  "expires_at": 0,  "agent_id": "string",  "team_id": "string",  "workflow_id": "string",  "user_id": "string",  "schedule_id": "string",  "schedule_run_id": "string",  "source_name": "string",  "requirements": [    {}  ],  "context": {},  "resolution_data": {},  "resolved_by": "string",  "resolved_at": 0,  "created_at": 0,  "updated_at": 0,  "run_status": "PENDING"}