Applies to:
- Plan - Any
- Deployment - Any
- Omit sampling parameters when using Claude Sonnet 5.5 to avoid 400 errors in both the UI and application code
Summary
Claude Sonnet 5.5 requests can fail with HTTP 400 when sampling parameters are sent. Removetemperature, top_p, and top_k from your playground prompt or application request.
What is happening
Claude Sonnet 5.5 does not support custom sampling values. Saved prompt settings, application code, or framework defaults can add these parameters to a request. The validation rules depend on the Claude API version:- With API version
2023-06-01, non-default sampling values return HTTP 400 on Claude Sonnet 5.5. - With API version
2026-10-21, sending any of these parameters returns HTTP 400 on every model, even at the parameter’s default value.
temperature to 0 still sends the parameter.
Fix
In a Braintrust playground
- Open the failing prompt and select the affected Claude model.
- Open Model parameters.
- For each configured Temperature, Top p, or Top k setting, click the beside its value to remove it.
- Run the prompt again.
In application code
Removetemperature, top_p, and top_k from the parameters passed to your model client.
For Braintrust prompt definitions, remove these keys from params. For direct Anthropic Messages API requests, remove them from the top level of the request body.
Check framework defaults and gateway overrides if the error persists. These settings can add sampling parameters after you remove them from your application code.
For direct Anthropic Messages API requests, set model to claude-sonnet-5-5. If you use another provider, use its corresponding identifier from Anthropic’s model comparison.
How to confirm it worked
- Retry the same prompt and confirm that the sampling parameter error no longer appears.
- For application requests, inspect the outgoing request body and confirm that
temperature,top_p, andtop_kare absent.