# Approvals

Manage API actions queued for human approval. When an API key has a "with Approval" permission level, write operations are held here until a team member reviews them.

**Base URL:** `https://api.trustpager.com/functions/v1/api/v1`

## Endpoints

### GET /approvals

List pending (or all) approval requests for the company.

**Scopes:** _none_ — [full detail](./approvals/get-approvals.md)

### GET /approvals/:id

Get a single approval request by ID.

**Scopes:** _none_ — [full detail](./approvals/get-approvals-id.md)

### POST /approvals/:id/approve

Approve and execute a queued API action. The stored operation is run immediately and the result is saved on the approval record.

**Scopes:** _none_ — [full detail](./approvals/post-approvals-id-approve.md)

### POST /approvals/:id/reject

Reject a queued API action. The action is NOT executed. An optional rejection reason can be provided.

**Scopes:** _none_ — [full detail](./approvals/post-approvals-id-reject.md)

### POST /approvals/:id/assign

Reassign the primary or secondary reviewer for a pending approval. Useful for routing approvals to the right team member. Only works on approvals with status "pending". Requires the approvals:reassign scope.

**Scopes:** `approvals:reassign` — [full detail](./approvals/post-approvals-id-assign.md)