---
title: "Decide an approval"
description: "Let a person decide before a tool call runs, with the job waiting durably until someone does."
canonical_url: "https://docs.oz0.ai/agents/approvals"
---
# 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](https://docs.oz0.ai/agents/approvals/recovery#unknown-outcomes); 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

```bash [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](https://docs.oz0.ai/build/apps/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:

```text
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](https://docs.oz0.ai/agents/approvals/configure)
- [How approval decisions bind a call](https://docs.oz0.ai/agents/approvals/security)
- [Edit an approval or allow repeated calls](https://docs.oz0.ai/agents/approvals/edits-and-repeat-calls)
- [Resolve loop, budget and recovery waits](https://docs.oz0.ai/agents/approvals/recovery)
- [Review approval statistics and test cards](https://docs.oz0.ai/agents/approvals/statistics)
- [Decide approvals from an app](https://docs.oz0.ai/agents/approvals/apps)

<legacy-sections>
<span id="a-decision-is-bound-to-the-call">

a decision is bound to the call

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/security#a-decision-is-bound-to-the-call).

<span id="agreement-per-agent-and-action-class">

agreement per agent and action class

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/statistics#agreement-per-agent-and-action-class).

<span id="allow-the-same-call-again">

allow the same call again

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/edits-and-repeat-calls#allow-the-same-call-again).

<span id="approve-with-edits">

approve with edits

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/edits-and-repeat-calls#approve-with-edits).

<span id="approver-statistics">

approver statistics

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/statistics#approver-statistics).

<span id="checked-again-after-a-long-wait">

checked again after a long wait

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/security#checked-again-after-a-long-wait).

<span id="deadlines">

deadlines

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/configure#deadlines).

<span id="edit-forms-in-chat-threads">

edit forms in chat threads

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/edits-and-repeat-calls#edit-forms-in-chat-threads).

<span id="from-your-own-app">

from your own app

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/apps#from-your-own-app).

<span id="keys-that-decide">

keys that decide

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/configure#keys-that-decide).

<span id="load-and-floods">

load and floods

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/statistics#load-and-floods).

<span id="loop-and-budget-waits">

loop and budget waits

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/recovery#loop-and-budget-waits).

<span id="one-turn-waits-as-a-whole">

one turn waits as a whole

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/security#one-turn-waits-as-a-whole).

<span id="restart-waits">

restart waits

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/recovery#restart-waits).

<span id="test-approvals">

test approvals

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/statistics#test-approvals).

<span id="the-escalation-ladder">

the escalation ladder

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/configure#the-escalation-ladder).

<span id="the-field-set">

the field set

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/edits-and-repeat-calls#the-field-set).

<span id="unknown-outcomes">

unknown outcomes

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/recovery#unknown-outcomes).

<span id="what-happens">

what happens

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/security#what-happens).

<span id="what-lies-outside-the-request">

what lies outside the request

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/security#what-lies-outside-the-request).

<span id="what-the-card-shows">

what the card shows

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/security#what-the-card-shows).

<span id="who-decides">

who decides

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals/configure#who-decides).

<span id="decide-from-the-web-ui">

decide from the web ui

</span>

: [Read the section](https://docs.oz0.ai/agents/approvals#decide-from-the-console).

</legacy-sections>


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.
