Answer: A result message can end with subtype "success" while structured_output is None because either Claude declined the request (check stop_reason for "refusal") or the schema cannot be satisfied by any output (for example, contradictory constraints like a minLength greater than maxLength). Treat this result as a failure in application code. Status: Confirmed Entry: tool/claude-code/troubleshooting/structured-output-none Revision: 3 Digest: sha256:b70794d6a2ff03e5 (changes whenever the content changes) Timeline: Created: 2026-11-13T12:07:34Z Last changed: 2026-11-17T12:21:55Z (cause 2: unsatisfiable schema example: — → minLength) Last verified: 2026-11-20T12:17:37Z Next check: 2026-11-21T12:17:37Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of result subtype | success | [1] | 2026-11-20 structured_output value | None | [1] | 2026-11-20 cause 1: declined request | refusal | [1] | 2026-11-20 cause 2: unsatisfiable schema example | minLength | [1] | 2026-11-20 Sources: [1] Anthropic. "Troubleshoot the Agent SDK". https://code.claude.com/docs/en/agent-sdk/troubleshooting.md Role: primary. Accessed: 2026-11-20T12:17:37Z Quote: "A result message can end with `subtype: "success"` while `structured_output` is `None` in Python or `undefined` in TypeScript." (Supports: result subtype) Quote: "while `structured_output` is `None` in Python or `undefined` in TypeScript" (Supports: structured_output value) Quote: "check the result message's `stop_reason` for `"refusal"`" (Supports: cause 1: declined request) Quote: "for example, a string whose `minLength` is greater than its `maxLength`" (Supports: cause 2: unsatisfiable schema example) Published: 2026-11-20T10:32:58Z Snapshot SHA-256: d35164042d96d0fc667e6ccb7e3b98f3122f76abadedb2d496f2eaea23598090 (captured 2026-11-17T12:21:55Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-17T12:21:55Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:17:37Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:17:37Z Last attempt: 2026-11-20T12:17:37Z Notes and limitations: Extracted automatically from a single official source. Related: https://latestn.com/tool/claude-code/troubleshooting/test-clean-configuration How do I test Claude Code with a clean configuration to find what's overriding my settings? https://latestn.com/tool/claude-code/troubleshooting/troubleshoot-claude-not-responding How do I troubleshoot Claude Code GitHub Actions when Claude is not responding to @claude commands? https://latestn.com/tool/claude-code/troubleshooting/troubleshoot-gateway-errors How do I troubleshoot LLM gateway errors in Claude Code? https://latestn.com/tool/claude-code/troubleshooting/sso-auth-loop-troubleshooting How do I troubleshoot authentication loops with SSO and corporate proxies in Claude Code on Amazon Bedrock? https://latestn.com/tool/claude-code/troubleshooting/status-line-troubleshooting Why is my Claude Code status line not appearing or showing empty values? https://latestn.com/tool/claude-code/troubleshooting/structured-output-error-handling What happens when Claude Code structured output validation fails and how is it handled? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-17T12:21:55Z | changed | cause 2: unsatisfiable schema example: — → minLength | [1] 2026-11-17T12:21:55Z | changed | cause 1: declined request: — → refusal | [1] 2026-11-17T12:21:55Z | changed | structured_output value: — → None | [1] 2026-11-17T12:21:55Z | changed | result subtype: — → success | [1] 2026-11-17T12:21:55Z | changed | recommended action: Treat this result as a failure in application code. → — | [1] 2026-11-17T12:21:55Z | changed | cause 2: A schema no output can satisfy → — | [1] 2026-11-17T12:21:55Z | changed | cause 1: A request that Claude declined → — | [1] 2026-11-15T12:17:12Z | changed | recommended action: — → Treat this result as a failure in application code. | [1] 2026-11-15T12:17:12Z | changed | recommended handling: Treat this result as a failure in application code. → — | [1] 2026-11-13T12:07:34Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/troubleshooting/structured-output-none/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/troubleshooting/structured-output-none POST: https://latestn.com/dispute/tool/claude-code/troubleshooting/structured-output-none with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/troubleshooting/structured-output-none?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). Why does the Claude Code Agent SDK return a successful result but structured_output is None? Revision 3, last verified 2026-11-20T12:17:37Z. https://latestn.com/tool/claude-code/troubleshooting/structured-output-none (accessed 2026-11-21T09:54:51Z). @misc{LatestN_tool_claude_code_troubleshooting_structured_output_none_r3, title = {Why does the Claude Code Agent SDK return a successful result but structured_output is None?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/troubleshooting/structured-output-none}}, note = {Revision 3; digest sha256:b70794d6a2ff03e5; last verified 2026-11-20T12:17:37Z; accessed 2026-11-21T09:54:51Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/troubleshooting/structured-output-none