Approval Flow
When a user triggers a tool decorated with@approval, the run pauses and a pending record is persisted to the database. An admin resolves the request via the AgentOS Control Panel or the API, and the run resumes.
Managing Approvals
View and resolve pending approvals from the AgentOS Control Panel. Each entry shows the agent, tool, arguments, and requesting user.

Approval Types
| Type | Behavior | Use Case |
|---|---|---|
@approval (default) | Blocking. Run pauses until an admin approves or rejects. | Deletions, payments, bulk operations |
@approval(type="audit") | Non-blocking. Run continues; an audit record is created after resolution. | Compliance logging, activity auditing |
Approvals API
| Operation | Endpoint |
|---|---|
| List approvals | GET /approvals |
| Get approval | GET /approvals/{approval_id} |
| Get approval status | GET /approvals/{approval_id}/status |
| Get approval count | GET /approvals/count |
| Resolve approval | POST /approvals/{approval_id}/resolve |
| Delete approval | DELETE /approvals/{approval_id} |
Next Steps
| Task | Guide |
|---|---|
| Blocking approval basics | Approval basic |
| List and resolve workflow | Approval list and resolve |
| Audit-style approvals | Audit approval |
| Team-level approvals | Team approval |
| API reference | Approval API schemas |