Search the documentation
50 pages for refused.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it. Cut at 50, so a narrower query shows the rest.
Or, for the model with the same capabilities and no access approval requirement:
Claude Developer Platform · in the page
about-claude/models/migration-guide
…he full set. You are not billed for the input tokens of a request refused before any output is generated. When a classifier fires mid-stream, the input and already-streamed output are billed; disc…
optimizing-for-cost-and-intelligence
Claude Developer Platform · in the page
about-claude/models/optimizing-for-cost-and-intelligence
…ools (August 26 to 27, 2026); scored on the 33 tasks no configuration refused, with attempts the production safety classifiers cut short removed; costs are what a customer is billed, the platform's re…
browser-use-tool
Claude Developer Platform · in the page
agents-and-tools/tool-use/browser-use-tool
…d` doesn't. Other common cases: <AccordionGroup> <Accordion title="Refused navigation scheme"> ```json { "type": "tool_result", "tool_use_id": "toolu_01LeUTyqkhRxBFq1QTG3pkwN",…
Beta
Claude Developer Platform · in the page
api/beta
…rom a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens for…
Messages
Claude Developer Platform · in the page
api/beta/messages
…rom a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens for…
Batches
Claude Developer Platform · in the page
api/beta/messages/batches
…a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens…
Create a Message Batch
Claude Developer Platform · in the page
api/beta/messages/batches/create
…a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens…
Retrieve Message Batch results
Claude Developer Platform · in the page
api/beta/messages/batches/results
…Opaque code that refunds the cache-miss cost when retrying this refused request on the fallback model. Pass it as `fallback_credit_token` on the retry request. Expires 5…
Create a Message
Claude Developer Platform · in the page
api/beta/messages/create
…rom a prior refusal's `stop_details`. When a preceding request was refused and returned a `fallback_credit_token`, pass that code here on the retry to have the retry's cache-creation tokens for…
fallback-credit
Claude Developer Platform · in the page
build-with-claude/fallback-credit
…escription: Avoid paying the prompt-cache cost twice when you retry a refused request on another model. --- Prompt caches are per-model. When a model declines a request and you retry on another model…
handling-stop-reasons
Claude Developer Platform · in the page
build-with-claude/handling-stop-reasons
…stop_details` is `null` for all stop reasons other than `refusal`. A refused request on Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, or Claude Opus 5 can usually be served by retrying on anothe…
overview
Claude Developer Platform · in the page
build-with-claude/overview
…| Avoid paying the prompt-cache cost twice when you retry a refused request on another model. The refusal carries a credit token, and echoing it on the retry bills the retry as though the co…
refusals-and-fallback
Claude Developer Platform · in the page
build-with-claude/refusals-and-fallback
…le and Claude Opus models return classifier refusals and how to retry refused requests on a fallback model. --- Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, and Claude Opus 5 include safety cla…
search-results
Claude Developer Platform · in the page
build-with-claude/search-results
…ect and handle refusal stop reasons in streaming responses, and retry refused requests on a fallback model. </Card> <Card title="Citations" icon="book" href="https://platform.claude.com/docs/en/b…
thinking
Claude Developer Platform · in the page
build-with-claude/thinking
…it the model's internal reasoning as part of the response text can be refused with `stop_details.category: "reasoning_extraction"`. See [Refusal categories](https://platform.claude.com/docs/en/build-w…
inference-hooks-endpoint
Claude Developer Platform · in the page
manage-claude/inference-hooks-endpoint
…ly routable host (private, loopback, and carrier-grade NAT ranges are refused at connect time), with a certificate that validates against the public CA trust store, responding without redirects. The c…
Or, for the Project Glasswing model with the same capabilities:
Claude Developer Platform · in the page
models/fable-5-1/migration-guide
…nd reading `stop_details.category` before response content. To re-run refused requests on another model automatically, set `fallbacks: "default"` (beta, `server-side-fallback-2026-07-01` header). `"de…
whats-new-fable-5-1
Claude Developer Platform · in the page
models/fable-5-1/whats-new-fable-5-1
…se) object naming the policy area that fired. * **Fallback:** retry a refused request on another model with [server-side fallback](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fa…
introducing-claude-fable-5-and-claude-mythos-5
Claude Developer Platform · in the page
models/fable-5/introducing-claude-fable-5-and-claude-mythos-5
…lback-credit). ### Billing You are not billed for a request that is refused before any output is generated. When you retry on another model, [fallback credit](https://platform.claude.com/docs/en/bui…
Or, for the model with the same capabilities and no access approval requirement:
Claude Developer Platform · in the page
models/fable-5/migration-guide
…he full set. You are not billed for the input tokens of a request refused before any output is generated. When a classifier fires mid-stream, the input and already-streamed output are billed; disc…
Opus migration
Claude Developer Platform · in the page
models/opus-5/migration-guide
…e cyber-category refusals can fall back to Claude Opus 4.8. To re-run refused requests on another model automatically, consider the `fallbacks` parameter with the `"default"` mode (`fallbacks: "defaul…
Sonnet migration
Claude Developer Platform · in the page
models/sonnet-5/migration-guide
…ests that involve prohibited or high-risk cybersecurity topics may be refused. Refusals return as a successful HTTP 200 response with `stop_reason: "refusal"`, not an error. See [Real-time cyber safeg…
whats-new-sonnet-5
Claude Developer Platform · in the page
models/sonnet-5/whats-new-sonnet-5
…ests that involve prohibited or high-risk cybersecurity topics may be refused. Refusals return as a successful HTTP 200 response with `stop_reason: "refusal"`, not an error. See [Real-time cyber safeg…
overview
Claude Developer Platform · in the page
release-notes/overview
…PI returns `stop_reason: "refusal"`. You are not billed for a request refused before any output is generated. An opt-in `fallbacks` parameter (in beta on the Claude API and Claude Platform on AWS; not…
handle-streaming-refusals
Claude Developer Platform · in the page
test-and-evaluate/strengthen-guardrails/handle-streaming-refusals
…ect and handle refusal stop reasons in streaming responses, and retry refused requests on a fallback model. --- Starting with Claude 4 models, streaming responses from Claude's API return **`stop_rea…
Escalate hard decisions with the advisor tool
Claude Code CLI · in the page
advisor
…model`](/docs/en/model-config#setting-your-model). If the API already refused the saved advisor in the current conversation, it stays off until `/clear` or `/compact`, even after you switch models. O…
Subagents in the SDK
Claude Code CLI · in the page
agent-sdk/subagents
…ltracode](/docs/en/model-config#adjust-effort-level) active are never refused. See the [concurrent subagent limit](/docs/en/sub-agents#concurrent-subagent-limit) | | Spend…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…an absent field tell you. * `startup_failure_reason`: why Claude Code refused to start, on the `error_during_execution` result it writes before exiting on a known startup failure. See [`startup_failur…
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…-unpushed <commit>@<worktree-id>` | Delete a session whose delete was refused over unpushed commits, discarding the worktree along with its branch and commits. Pass the exact value that refusal printe…
Share session output as artifacts
Claude Code CLI · in the page
artifacts
…sn't decode, or that contains the replacement character `U+FFFD`, is [refused with the line and column to fix](/docs/en/errors#the-source-file-is-not-valid-utf-8-text).…
Configure auto mode
Claude Code CLI · in the page
auto-mode-config
…-safety-of-an-action), because a safety check separate from auto mode refused the classifier's own request or its response didn't parse, Claude Code denies the action without recording it under **Rece…
Claude Code changelog
Claude Code CLI · in the page
changelog
…ile scope when that capability was re-sent without them; they are now refused * Fixed `/ultrareview` reporting a stopped cloud review as completed or as an error to retry, and waiting out the full t…
Channels reference
Claude Code CLI · in the page
channels-reference
…claude/debug/<session-id>.txt`. * **`curl` fails with "connection refused"**: the port is either not bound yet or a stale process from an earlier run is holding it. `lsof -i :<port>` shows what's…
Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry
Claude Code CLI · in the page
claude-apps-gateway
…and sign-in to one on a public address outside every listed block is refused as before. A declared block narrows who can sign in but doesn't prove where a machine is, so declare only address space y…
Claude apps gateway configuration
Claude Code CLI · in the page
claude-apps-gateway-config
…s-gateway-deploy#threat-model-summary) blocks every export with `ECONNREFUSED_SSRF` unless you set `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1` in the gateway's environment * `http://127.0.0.1:<port>` or `http:/…
Claude apps gateway deployment and operations
Claude Code CLI · in the page
claude-apps-gateway-deploy
…ification page, with the settings to check. It also writes a `sign-in refused` log line that names the setting to change. ## Operations Once the gateway is serving traffic, day-to-day operation is r…
CLI reference
Claude Code CLI · in the page
cli-reference
…w#manage-sessions-from-the-shell) from the list. When the removal is [refused over the session's worktree](/docs/en/agent-view#what-deleting-a-session-removes) and a second `claude rm` can resolve it,…
Communications kit
Claude Code CLI · in the page
communications-kit
…to an earlier Opus, except that flagged biology content on Opus 5 is refused. *Try it now:* type `/model` and pick Sonnet if you haven't already. It is the right default for most tasks. 📖 Model con…
Message your other Claude Code sessions
Claude Code CLI · in the page
cross-session-messaging
…when you approve it or a later mode or settings change allows it. * **Refused**: Claude Code drops the message without delivering it. Once delivered, the message counts toward [usage](/docs/en/costs)…
Error reference
Claude Code CLI · in the page
errors
…| | `Agent aborted: auto mode classifier request refused by the safety safeguard`…
Speed up responses with fast mode
Claude Code CLI · in the page
fast-mode
…ection) allowlist excludes the fast-mode Opus model, turning it on is refused with "is not in your organization's allowed models". In a session already running on an allowed Opus model that supports f…
Hooks reference
Claude Code CLI · in the page
hooks
…a classifier verdict because [a safety check separate from auto mode refused the classifier's own request](/docs/en/errors#auto-mode-cannot-determine-the-safety-of-an-action) or its response didn't p…
Connect Claude Code to an LLM gateway
Claude Code CLI · in the page
llm-gateway-connect
…| | `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` when nothing answers at the address, or `Can't reach the API…
Deploy managed settings
Claude Code CLI · in the page
managed-settings
…sages](/docs/en/cross-session-messaging#control-inbound-messages) are refused until the value is fixed. The developer sees [a warning](/docs/en/errors#crosssessioninbound-must-be-one-of-accept-hold-re…
Connect Claude Code to tools via MCP
Claude Code CLI · in the page
mcp
…on fails with a transient error, such as a 5xx response, a connection refused, or a timeout, Claude Code retries up to three times. If the connection still fails, Claude Code marks the server as faile…
Model configuration
Claude Code CLI · in the page
model-config
…or later * **[Fast mode](/docs/en/fast-mode)**: enabling fast mode is refused when the model the session would run on afterward is outside the allowlist ```json theme={null} { "availableModels": ["…
Monitoring
Claude Code CLI · in the page
monitoring-usage
…ce, machines whose policy helper is failing, and the reason a machine refused to start. Requires Claude Code v2.1.274 or later. By default, the event carries the managed sources and the policy helper…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…the prompt doesn't appear again * **Block from now on**: the read is refused, and Claude Code sets [`permissions.blockReadsOutsideWorkingDirectories`](/docs/en/settings-reference#permissions-blockrea…
Test plugins with evals
Claude Code CLI · in the page
plugin-evals
…code and suite you'd run yourself. Pass it in CI so the job is never refused by or left waiting at the prompt. See [What a run can access](#security)…
Create and distribute a plugin marketplace
Claude Code CLI · in the page
plugin-marketplaces
…plugins in a bulk install still install. A plugin that depends on the refused plugin fails to install until the user installs the refused plugin by itself. * **Background auto-update, or session start…