[DOCS] Agent SDK Python: Bash tool input schema missing dangerouslyDisableSandbox field

Resolved 💬 3 comments Opened Jan 25, 2026 by coygeek Closed Mar 1, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://platform.claude.com/docs/en/agent-sdk/python

Section/Topic

"Tool Reference" section → "Bash" subsection → Input schema definition

Current Documentation

The Bash tool input schema:

``python { "command": str, "timeout": int | None, "description": str | None, "run_in_background": bool | None } ``

What's Wrong or Missing?

The Bash input schema omits the dangerouslyDisableSandbox field. However, the "Permissions Fallback for Unsandboxed Commands" example later on the same page accesses this field:

if tool == "Bash" and input.get("dangerouslyDisableSandbox"):

While Python dictionaries are dynamic and this won't cause runtime errors, the documentation is internally inconsistent. Users reading the Bash schema will not know this field exists, yet the sandbox permission example relies on it.

Suggested Improvement

Before:

{
"command": str,
"timeout": int | None,
"description": str | None,
"run_in_background": bool | None
}

After:

{
"command": str,
"timeout": int | None,
"description": str | None,
"run_in_background": bool | None,
"dangerouslyDisableSandbox": bool | None
}

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://platform.claude.com/docs/en/agent-sdk/python | 1463-1469 | Bash input schema (missing field) |
| https://platform.claude.com/docs/en/agent-sdk/python | 2350 | Example using input.get("dangerouslyDisableSandbox") |

Related: This is the same pattern as #19693 (missing Bash schema field) and the TypeScript equivalent issue.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗