claude-code - 💡(How to fix) Fix [DOCS] Agent SDK quickstart shows pre-v2.1.129 raw JSON for a 400 API error [1 comments, 2 participants]

Troubleshooting → API error \thinking.type.enabled` is not supported for this model`

Claude Opus 4.7 replaces thinking.type.enabled with thinking.type.adaptive. Older Agent SDK versions fail with the following API error when you select claude-opus-4-7: API Error: 400 {"type":"invalid_request_error","message":"\"thinking.type.enabled\" is not supported for this model. Use \"thinking.type.adaptive\" and \"output_config.effort\" to control thinking behavior."} This troubleshooting example appears to reflect the older pre-v2.1.129 behavior where an unrecognized 400 surfaced the raw JSON body instead of the underlying user-facing error message. That makes the page inconsistent with the current Claude Code behavior described in the v2.1.129 changelog entry, and inconsistent with the main error reference page, which already documents this error family using a cleaned message format instead of a raw JSON object. Update the quickstart example to match the current user-facing 400 error format rather than showing the raw JSON payload. For this specific troubleshooting case, the safest fix is to reuse the cleaned wording already shown on the main error reference page for the same thinking.type.enabled error, then keep the upgrade guidance (Upgrade to Agent SDK v0.2.111 or later) below it. | https://code.claude.com/docs/en/agent-sdk/quickstart | 314-322 | Troubleshooting example still shows API Error: 400 {"type":"invalid_request_error",...} | | https://code.claude.com/docs/en/errors | The thinking.type.enabled is not supported for this model section already uses a cleaned API Error: 400 ... format instead of raw JSON | Relevant changelog context: v2.1.129 says Claude Code fixed API errors with unrecognized 400 status codes showing raw JSON instead of the underlying error message.

TL;DR

Update the troubleshooting example in the quickstart documentation to match the current user-facing 400 error format.

Guidance

• Review the main error reference page to reuse the cleaned wording for the thinking.type.enabled error.
• Replace the raw JSON payload in the quickstart example with the cleaned error message.
• Keep the upgrade guidance (Upgrade to Agent SDK v0.2.111 or later) below the updated error message.
• Verify the change by checking the affected page (https://code.claude.com/docs/en/agent-sdk/quickstart, lines 314-322) to ensure the updated error format is displayed.

Example

No code snippet is necessary for this documentation update.

Notes

This change only affects the documentation and does not impact the underlying API or Agent SDK behavior.

Recommendation

Apply workaround: Update the documentation to reflect the current user-facing error format, as this will improve the consistency and clarity of the troubleshooting guide.