Decide an approval
For: people running and reviewing agents.
Open the waiting approval, inspect the actual call and its arguments, then approve or deny it. Check the system a tool writes to before deciding a call whose outcome is unknown. A decision applies to the call shown; an edited call or changed policy can require another decision.
Decide from the console
- Open Run, Approvals, then Waiting in the console. The list is oldest first and shows the waiting item, agent, job, elapsed wait and deadline, with a count of waiting items.
- Open an item to inspect its arguments in the dialog. You can also find pending approvals above the tabs on the job's page.
- Inspect the call and add a comment if the agent needs your reason.
- Choose Approve or Deny. An item marked outcome unknown instead offers three recovery answers; check the target system before choosing one.
Operators, admins and owners of the tenant decide; readers see what waits but cannot decide, and see the call's arguments only with the permission to see the tenant's content.
What you approve is what the agent sends: invisible characters in the arguments (Unicode TAG characters, zero-width characters, bidi controls and the like, which a screen does not draw but a model or a tool reads) are shown as escapes such as \u{200B}, in the console, in chat threads, in oz0 approval list and in an MCP client's elicitation.
Decide from the CLI
oz0 approval list
oz0 approval args job-bb270cf1-... a-3d3774fd06c3 # the whole arguments and their digest
oz0 approval approve job-bb270cf1-... a-3d3774fd06c3 --comment "fine by me"
oz0 approval deny job-bb270cf1-... a-3d3774fd06c3 --comment "not before the release"
oz0 approval decide job-bb270cf1-... a-3d3774fd06c3 happened # a write whose outcome is unknown
oz0 approval list shows each approval's level, its step on the ladder, the deadline that denies it, the arguments out of scope (OUT-OF-SCOPE:to) and, when the origin check or a sequence rule asked, ASKED-BY:ORIGIN or ASKED-BY:SEQUENCE.
When the list is only part of the queue (more jobs wait than one list reads, a thousand, or a job's approvals are in a form the server cannot read), it says so, as the console's queue does, and so do oz0 job get and the runtime API's job (approvals_partial) for a job whose approvals the server cannot all read; an AG-UI thread starts no new turn while what its turn waits for is only partly read; a decision on an approval the server cannot read is refused, never sent unchecked.
Right after a server starts, while its search attributes load, the list answers unavailable (try again) rather than an empty queue.
oz0 run and job watch show a waiting call as it happens, with the command that approves it:
helper → team.hello {"name":"e2e"}
helper ⏸ team.hello waits for approval a-3d3774fd06c3: {"name": "e2e"}
oz0 approval approve job-0879b9bc-... a-3d3774fd06c3 (or deny)
helper ▶ team.hello approved by operator:admin: fine by me
helper ← team.hello Hello, e2e!
Related tasks and reference
- Configure approval ownership and deadlines
- How approval decisions bind a call
- Edit an approval or allow repeated calls
- Resolve loop, budget and recovery waits
- Review approval statistics and test cards
- Decide approvals from an app
Previous section links
a decision is bound to the call: Read the section.
agreement per agent and action class: Read the section.
allow the same call again: Read the section.
approve with edits: Read the section.
approver statistics: Read the section.
checked again after a long wait: Read the section.
deadlines: Read the section.
edit forms in chat threads: Read the section.
from your own app: Read the section.
keys that decide: Read the section.
load and floods: Read the section.
loop and budget waits: Read the section.
one turn waits as a whole: Read the section.
restart waits: Read the section.
test approvals: Read the section.
the escalation ladder: Read the section.
the field set: Read the section.
unknown outcomes: Read the section.
what happens: Read the section.
what lies outside the request: Read the section.
what the card shows: Read the section.
who decides: Read the section.
decide from the web ui: Read the section.