What
The permission-mode field is now a described enum listing all six modes, so SDK and tooling that read the schema see what each does: auto uses a model classifier to approve or deny permission prompts, and dontAsk never prompts and denies anything not pre-approved.
Evidence
'auto' - Use a model classifier to approve/deny permission prompts.
Strings lifted out of the shipped bundle, so the claim above can be checked against them.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Added since
A small documentation edit on Run Claude Code programmatically touched a line naming dontAsk after this was published.
* **`dontAsk`**: Claude Code denies every call that would otherwise prompt, which is useful for locked-down CI runs. Actions that need no approval in Manual mode still run, such as file reads in your working directories and the [read-only …headless see the edit
Confirmed since
Anthropic's documentation has since written up dontAsk, on Orchestrate teams of Claude Code sessions.
Teammates start with the lead's permission mode, except [`dontAsk` mode](/docs/en/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), which they don't inherit. If the lead runs with `--dangerously-skip-permissions`, all team…agent-teams see the edit
Confirmed since
Anthropic's documentation has since written up auto, on Give Claude access to your tools.
A Datadog API key, for example, makes the API reachable, and a Datadog plugin tells Claude which endpoints answer which questions. Sessions in covered channels pick up attached plugins automatically, with nothing to install or enable. Chan…claude-tag/admins/add-connections see the edit
Added since
A small documentation edit on Orchestrate subagents at scale with dynamic workflows touched a line naming auto after this was published.
An `agent()` call resolves to `null` if you stop it mid-run or it hits an unrecoverable API error. In [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode), the classifier can block an `agent()` call before the subagent s…workflows see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
A small documentation edit on Orchestrate subagents at scale with dynamic workflows touched a line naming auto after this was published.