936 pages for error.

user-profiles Claude Developer Platform · in the page manage-claude/user-profiles …tion that sends the request, the API returns a `400` `invalid_request_error`. By default, these platforms accept a profile ID only on requests from the organization that created the profile. This mean… wif-admin-api Claude Developer Platform · in the page manage-claude/wif-admin-api …eference): environment variables, validation rules, OAuth scopes, and error codes * [Admin API](https://platform.claude.com/docs/en/manage-claude/admin-api): the rest of the organization management su… aws Claude Developer Platform · in the page manage-claude/wif-providers/aws …sToken := option.IdentityTokenFunc(func(ctx context.Context) (string, error) { out, err := stsClient.GetWebIdentityToken(ctx, &sts.GetWebIdentityTokenInput{ Audience: []string{"https://… Create the app registration that represents the Claude API audience. Claude Developer Platform · in the page manage-claude/wif-providers/azure …gistration, token requests fail with a “resource not found in tenant” error (`AADSTS50001` from the managed identity endpoints, `AADSTS500011` from the Entra token endpoint). ```bash # Create the app… gcp Claude Developer Platform · in the page manage-claude/wif-providers/gcp …anthropic.com" googleIDToken := func(ctx context.Context) (string, error) { creds, err := idtoken.NewCredentials(&idtoken.Options{Audience: audience}) if err != nil { return "", err }… github-actions Claude Developer Platform · in the page manage-claude/wif-providers/github-actions …in seconds. A denied exchange returns an opaque `401` `authentication_error` with the fixed message `Authentication failed`, whichever check failed. In most cases, the attempt’s entry on the [authenti… kubernetes Claude Developer Platform · in the page manage-claude/wif-providers/kubernetes …y during cluster upgrades), but token exchanges fail with a signature error until you push the new JWKS. </Warning> **Federation rule:** Match the service account’s `sub` claim and the audience you s… okta Claude Developer Platform · in the page manage-claude/wif-providers/okta …o/v2/option" ) func fetchOktaToken(ctx context.Context) (string, error) { form := url.Values{ "grant_type": {"client_credentials"}, "scope": {"anthropic.acce… Replace NODE_UID with the node's UID: Claude Developer Platform · in the page manage-claude/wif-providers/spiffe …ce.Close() fetchJWTSVID := func(ctx context.Context) (string, error) { svid, err := source.FetchJWTSVID(ctx, jwtsvid.Params{Audience: audience}) if err != nil { return… wif-reference Claude Developer Platform · in the page manage-claude/wif-reference …: Environment variables, validation rules, profile configuration, and error reference for Workload Identity Federation. --- This page collects the configuration surfaces, validation constraints, and… workload-identity-federation Claude Developer Platform · in the page manage-claude/workload-identity-federation …xpiry minus 30 seconds. A failed exchange at this point results in an error. The cached token is too close to expiry to be safe. Because the SDK rereads `ANTHROPIC_IDENTITY_TOKEN_FILE` on every excha… workspaces Claude Developer Platform · in the page manage-claude/workspaces …when the request fails before authentication completes, such as a 401 error. The following examples send a Messages API request and read the workspace ID from the response headers: <CodeGroup> ```… agent-setup Claude Developer Platform · in the page managed-agents/agent-setup …go: `InferenceGeo`) on a model that doesn’t support it returns a 400 error. See [Model availability](https://platform.claude.com/docs/en/manage-claude/data-residency#model-availability) for the model… budgets Claude Developer Platform · in the page managed-agents/budgets …t to an existing session that doesn’t have one is rejected with a 400 error. A budgeted session’s cap can be [changed](https://platform.claude.com/docs/en/managed-agents/budgets#change-the-budget) or… dreams Claude Developer Platform · in the page managed-agents/dreams …e_read_input_tokens": 0, "cache_creation_input_tokens": 0 }, "error": null } ``` <Tip> If you only have session transcripts and no existing store, [create an empty memory store](https://pla… environments Claude Developer Platform · in the page managed-agents/environments …orking`) to `true`; otherwise, the API rejects the request with a 400 error. <CodeGroup defaultLanguage="CLI"> ```bash cURL curl -fsS https://api.anthropic.com/v1/environments \ -H "x-api-key… event-deltas Claude Developer Platform · in the page managed-agents/event-deltas …e `agent.message` and `agent.thinking`. Any other value returns a 400 error, as does a request with more than 100 values. Both stream endpoints accept the parameter: * **Session-level stream:** `GET… events-and-streaming Claude Developer Platform · in the page managed-agents/events-and-streaming …ion.status_idle": break case "session.error": error_message = event.error.message if event.error else "unknown" print(f"\n[Error: {e… files Claude Developer Platform · in the page managed-agents/files …ile_id: file.id }); if (resource.type !== "file") { throw new Error(`Unexpected resource type: ${resource.type}`); } console.log(resource.id); // "sesrsc_01ABC..." ``` ```csharp C#… github Claude Developer Platform · in the page managed-agents/github …ed-agents/environments#networking), session creation fails with a 400 error when the agent declares an MCP server whose host is not in `allowed_hosts` (java, php: `allowedHosts`; csharp, go: `AllowedH… mcp-connector Claude Developer Platform · in the page managed-agents/mcp-connector …ntials. With `limited` networking, session creation fails with a 400 error when the agent declares an MCP server whose host is not in `allowed_hosts` (java, php: `allowedHosts`; csharp, go: `AllowedH… memory Claude Developer Platform · in the page managed-agents/memory …r with `agent-memory-2026-07-22` on a memory store call returns a 400 error. Claude Platform on AWS: availability: beta note: On Claude Platform on AWS, sessions on self-hosted environ… multiagent-orchestration Claude Developer Platform · in the page managed-agents/multiagent-orchestration …efined_agents` list. With an empty list, the request fails with a 400 error. On an update, the server checks the settings as they stand after the update. The following agent allows only the agents th… permission-policies Claude Developer Platform · in the page managed-agents/permission-policies …s the call as high-risk, the tool does not run. The agent receives an error tool result with the content `Permission to use {tool_name} has been denied.` and `is_error: true`. The session keeps runnin… reference Claude Developer Platform · in the page managed-agents/reference …platform emits; a user event that includes one is rejected with a 400 error. </Tab> <Tab title="Session events"> | Type | Description… scheduled-deployments Claude Developer Platform · in the page managed-agents/scheduled-deployments …. Creating a deployment for an agent without this field returns a 400 error. * **Trust policy:** Allow the `aws-external-anthropic.amazonaws.com` service principal to call `sts:AssumeRole` and `sts… secure-deployment Claude Developer Platform · in the page managed-agents/secure-deployment …also apply in a session. With a tool turned off, its calls return an error result to the agent, and the session continues. With domain restrictions set, a search result or a fetched URL must pass bot… self-hosted-data-and-access Claude Developer Platform · in the page managed-agents/self-hosted-data-and-access …he log, traces, and metrics go The server writes its log to standard error. When you run the server under Docker, Kubernetes, or a service manager, that system collects the log from standard error.… spawn.sh: called once per claimed work item Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes …y on SIGTERM or SIGINT: it cancels any in-flight tool call, posts its error result, and releases the work item before stopping. **Sandbox per session** If you need stronger isolation… self-hosted-sandboxes-custom-tools Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-custom-tools …ut orderStatusInput) (anthropic.BetaToolResultBlockParamContentUnion, error) { return anthropic.BetaToolResultBlockParamContentUnion{ OfText: &anthropic.BetaTextBlockParam{Text: "Or… self-hosted-sandboxes-memory Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-memory …ctory, so it fails the work item. The session then stays idle with no error event. See [Memory stores fail to mount](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes-operations… self-hosted-sandboxes-operations Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-operations …es both signals itself: it cancels any in-flight tool call, posts its error result, and marks the work item `stopped`. | | SDK worker that is its own process | `EnvironmentWorker` installs no signa… self-hosted-sandboxes-workers Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-workers …num, task.cancel) with contextlib.suppress(asyncio.CancelledError): await task asyncio.run(main()) ``` ```typescript TypeScript import Anthropic from "@anthropic-ai/… agent-identity Claude Developer Platform · in the page managed-agents/self-hosted/agent-identity …s rules of its own. It refuses a request that breaks one with a `400` error that names the field. Two of those rules follow: * `networking` (csharp, go: `Networking`) must have the type `limited`, an… then: histchars= HISTFILE=/dev/null ant beta:worker poll --workdir /workspace Claude Developer Platform · in the page managed-agents/self-hosted/call-the-api …print(block.text, end="") case "session.error": error_message = event.error.message if event.error else "unknown" print(f"\n[Error: {e… configuration-reference Claude Developer Platform · in the page managed-agents/self-hosted/configuration-reference …server doesn’t start if its settings file has an unknown key, and the error says where the key is. * **Keys:** Each dot in a key is a level of nesting in the file. For example, `server.addr` is the `… differences Claude Developer Platform · in the page managed-agents/self-hosted/differences …environments exist. A request for a cloud environment returns a `400` error. | [Deploy self-hosted workers](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes-workers) for… inference-provider Claude Developer Platform · in the page managed-agents/self-hosted/inference-provider …e callback or the token endpoint fails, the turn ends with a `session.error` event of type `model_request_failed_error`, and the session stays usable. The reason is in the server log, on a line that c… kubernetes Claude Developer Platform · in the page managed-agents/self-hosted/kubernetes …prints the new key, and it prints the key’s ID and expiry on standard error. </Step> <Step title="Move your workers to the new key"> Set the new key as `ANTHROPIC_ENVIRONMENT_KEY` for each pr… quickstart Claude Developer Platform · in the page managed-agents/self-hosted/quickstart …it `could not determine the organization and workspace`, with a `404` error, and then creates the agent. That’s expected on your own server. </Step> <Step title="Start a session"> These comma… upgrade Claude Developer Platform · in the page managed-agents/self-hosted/upgrade …erver-<old-version>.dump.age ``` If either command prints an error, the file it leaves behind is not a backup. Fix the cause and run the command again before you go on. If the servers ar… session-observability Claude Developer Platform · in the page managed-agents/session-observability …. ## Debugging tips * **Check session events:** The session reports errors through [`session.error`](https://platform.claude.com/docs/en/managed-agents/reference#event-types) events. * **Review tool… session-operations Claude Developer Platform · in the page managed-agents/session-operations …| | `rescheduling` | Transient error occurred, retrying automatically.… session-threads Claude Developer Platform · in the page managed-agents/session-threads …requires_action`, the interrupt closes each pending tool call with an error tool result (“Tool execution was interrupted before completion. Please retry.”) and re-emits `session.thread_status_idle` wi… sessions Claude Developer Platform · in the page managed-agents/sessions …(csharp, go: `Model`) to `null` returns a 400 `agent_model_required` error. * Clearing `tools` (csharp, go: `Tools`) returns a 400 error when the session’s effective `skills` (csharp, go: `Skills`)… tools Claude Developer Platform · in the page managed-agents/tools …a built-in agent tool. A request that breaks this rule returns a 400 error. However, an existing custom tool might start with `ant__`. An agent with such a tool accepts an update only if the update s… tools-web-restrictions Claude Developer Platform · in the page managed-agents/tools-web-restrictions …If an administrator disables web search, `web_search` calls return an error result to the agent, and the session continues. If the organization restricts web search domains, the agent receives only th… vaults Claude Developer Platform · in the page managed-agents/vaults …so a create or update that would disable both locations returns a 400 error. Passing an explicit `null` for the `injection_location` (java, php: `injectionLocation`; csharp, go: `InjectionLocation`) o… webhooks Claude Developer Platform · in the page managed-agents/webhooks …| | `session.status_rescheduled` | A transient error occurred and the session is retrying automatically.… workflow-runs Claude Developer Platform · in the page managed-agents/workflow-runs …fetime from passing, so a run that stays paused can end with `timeout_error`. The following events report a run’s start, its phases, and its end. A pause at the budget sends one too. A pause after an…