Troubleshooting
Every error code is also listed in the API reference.
Subscribing
| Problem | Fix |
|---|---|
| Error page after Set up your account | Start again from Set up your account in the AWS Marketplace console |
| Claim fails: linked to another account | Sign in with the account that claimed it, or contact support |
Stays pending for over an hour | Contact support with your AWS account ID |
Connecting your AWS account
| Message after Test and save | Fix |
|---|---|
| "We couldn't assume this role" | Wait for CREATE_COMPLETE, check the Role ARN, or relaunch |
| "The role works, but it can't list Amazon Bedrock models" | The role was edited, or Bedrock is not available in that region |
Calling the API
| Problem | Fix |
|---|---|
401 invalid_api_key | The key is wrong or revoked. Create a new one on API keys |
403 bedrock_access_denied | The stack (role AICloudGatewayRouter-...) was deleted or changed. Relaunch it |
429 bedrock_throttled | Retry with backoff, or raise your quotas in AWS Service Quotas |
| Times out before any output | Use stream: true for long answers |
500 or 502 | Retry. If it persists, contact support |
Models and routing
| Problem | Fix |
|---|---|
403 bedrock_model_not_enabled, or no Claude | Enable the models the dashboard lists |
400 no_eligible_model | Trim the input, or enable more models |
| Turns of one conversation use different models | Expected with auto. Pin a model to keep one |
Budgets and guardrails
| Problem | Fix |
|---|---|
403 budget_exceeded | Raise or remove the limit, or wait for 00:00 UTC on the 1st |
| Estimated spend differs from AWS bill | Expected: the estimate uses on-demand list prices |
finish_reason is content_filter | Your guardrail or the model's filter blocked it |
403 bedrock_guardrail_denied | Relaunch the stack from AWS account, or remove the guardrail |
Still stuck? See Support.
Full guide: troubleshooting.md on GitHub