[DOCS] Agent SDK Python: Bash tool input schema missing dangerouslyDisableSandbox field
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.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗