Prudai Developer API: approvals
The operations of this part (Approvals).
Base URL https://api.prudai.com/v1. Logging in is in Login, scopes in Scopes and permissions, errors in Errors. Overview.
| Method | Path | What it does | State |
|---|---|---|---|
GET | /v1/approvals | List approval requests | In production |
GET | /v1/approvals/{id} | Read an approval request | In production |
List approval requests
GET /v1/approvals
- State: in production.
- Scope: none for your own data,
account:approvals:readfor the whole organisation’s; logging in with your key or token is required. - Approval:
none, no extra step.
Parameters
organization_wide
Default false: only your requests. true requires account:approvals:read. default:falsestatus
One of:pending,approved,rejected,expired,usedlimit
default:20· min 1 · max 100cursor
pattern^apr_[A-Za-z0-9]{24}$
Responses
| Status | Meaning |
|---|---|
200 | A page of approval requests, ordered by id descending. Follow next_cursor. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Unknown model, source or document. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
500 | Unexpected error on Prudai’s side. Not charged, except work that completed before the failure (reported in details.charged_credits). |
Fields in data (200)
approvalsapprovals[].id
pattern^apr_[A-Za-z0-9]{24}$approvals[].level
One of:confirm,reviewapprovals[].operationapprovals[].summary
Human-readable summary of a proposed chat action, when available.approvals[].methodapprovals[].path
Resolved path relative to /v1.approvals[].args_hash
pattern^[a-f0-9]{64}$approvals[].status
One of:pending,approved,rejected,expired,usedapprovals[].created_atapprovals[].expires_atapprovals[].approval_urlnext_cursor
may benull
curl -s "https://api.prudai.com/v1/approvals" \ -H "Authorization: Bearer $PRUDAI_TOKEN"prudai leo approvals list{ "approvals": [ { "id": "string", "level": "confirm", "operation": "string", "summary": "string", "method": "string", "path": "string", "args_hash": "string", "status": "pending", "created_at": "2026-11-05T09:30:00.000Z", "expires_at": "2026-11-05T09:30:00.000Z", "approval_url": "https://voorbeeld.nl" } ], "next_cursor": "string"}Read an approval request
GET /v1/approvals/{id}
- State: in production.
- Scope: none for your own data,
account:approvals:readfor the whole organisation’s; logging in with your key or token is required. - Approval:
none, no extra step.
Parameters
idrequired
pattern^apr_[A-Za-z0-9]{24}$organization_wide
Default false: only your requests. true requires account:approvals:read. default:false
Responses
| Status | Meaning |
|---|---|
200 | Approval request metadata. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Unknown model, source or document. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
500 | Unexpected error on Prudai’s side. Not charged, except work that completed before the failure (reported in details.charged_credits). |
Fields in data (200)
approvalRequestapprovalRequest.id
pattern^apr_[A-Za-z0-9]{24}$approvalRequest.level
One of:confirm,reviewapprovalRequest.operationapprovalRequest.summary
Human-readable summary of a proposed chat action, when available.approvalRequest.methodapprovalRequest.path
Resolved path relative to /v1.approvalRequest.args_hash
pattern^[a-f0-9]{64}$approvalRequest.status
One of:pending,approved,rejected,expired,usedapprovalRequest.created_atapprovalRequest.expires_atapprovalRequest.approval_url
curl -s "https://api.prudai.com/v1/approvals/<id>" \ -H "Authorization: Bearer $PRUDAI_TOKEN"prudai leo approvals get{ "approvalRequest": { "id": "string", "level": "confirm", "operation": "string", "summary": "string", "method": "string", "path": "string", "args_hash": "string", "status": "pending", "created_at": "2026-11-05T09:30:00.000Z", "expires_at": "2026-11-05T09:30:00.000Z", "approval_url": "https://voorbeeld.nl" }}