Skip to main content
Put a human in the loop for risky steps: posting a payment, deleting a record, sending the message. approval_request parks until an operator resolves it (or timeout_ms elapses), and every request emits approval_request and approval events so a dashboard can surface the queue live. CLI and cURL examples use $RT and browser b1 (Sessions).

Park until a decision

approval_request returns {approval_id, resolved, approved, note?} — the decision lands when approval_resolve fires with the same approval_id. An unresolved request returns resolved: false when its timeout elapses, so the agent can fall back or retry.
A parked approval never starves other calls on the same client — resolving, streaming events, and reading status all proceed while the request waits. Watch the approval_request event on the events stream to learn each request’s approval_id the moment it parks.