Run

Decide an approval

Let a person decide before a tool call runs, with the job waiting durably until someone does.

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

  1. 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.
  2. Open an item to inspect its arguments in the dialog. You can also find pending approvals above the tabs on the job's page.
  3. Inspect the call and add a comment if the agent needs your reason.
  4. 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

Terminal
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!
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.

Copyright © 2026