One read of Claude Developer Platformapi-20261021T000725Z
69 pages moved out of 796 read.
Pages moved
69
significant first
Pages read
796
in this capture
Captured
00:07 UTC
Corpus hash
9dff8f1e4a7e
corpus-hash
What this read moved
51-69 of 69, page 3 of 3This capture is too large to show at once. Changes 51-69 of 69 are below, significant first; the rest are on the following screens.
build-with-claude/claude-platform-on-aws Changed · +4 / -4 lines
from line 305
305305
306306 <Tab title="Java">
307307 ```kotlin Gradle
308 implementation("com.anthropic:anthropic-java:2.74.0")
309 implementation("com.anthropic:anthropic-java-aws:2.74.0")
308 implementation("com.anthropic:anthropic-java:2.75.0")
309 implementation("com.anthropic:anthropic-java-aws:2.75.0")
310310 ```
311311
312312 ```xml Maven
from line 313
313313 <dependency>
314314 <groupId>com.anthropic</groupId>
315315 <artifactId>anthropic-java</artifactId>
316 <version>2.74.0</version>
316 <version>2.75.0</version>
317317 </dependency>
318318 <dependency>
319319 <groupId>com.anthropic</groupId>
320320 <artifactId>anthropic-java-aws</artifactId>
321 <version>2.74.0</version>
321 <version>2.75.0</version>
322322 </dependency>
323323 ```
324324 </Tab>
cli-sdks-libraries/overview Changed · +15 / -0 lines
## Latest versions
from line 54
5454 </Card>
5555</CardGroup>
5656
57## Latest versions
58
59| Tool | Latest version | Package |
60| ---------- | -------------- | ----------------------------------------------------------------------------------------------------- |
61| ant CLI | `1.44.0` | [`github.com/anthropics/anthropic-cli`](https://github.com/anthropics/anthropic-cli/releases) |
62| Python | `1.17.0` | [`anthropic`](https://pypi.org/project/anthropic/) |
63| TypeScript | `0.137.0` | [`@anthropic-ai/sdk`](https://www.npmjs.com/package/@anthropic-ai/sdk) |
64| C# | `12.60.0` | [`Anthropic`](https://www.nuget.org/packages/Anthropic) |
65| Go | `1.84.0` | [`github.com/anthropics/anthropic-sdk-go`](https://pkg.go.dev/github.com/anthropics/anthropic-sdk-go) |
66| Java | `2.75.0` | [`com.anthropic:anthropic-java`](https://central.sonatype.com/artifact/com.anthropic/anthropic-java) |
67| PHP | `0.61.0` | [`anthropic-ai/sdk`](https://packagist.org/packages/anthropic-ai/sdk) |
68| Ruby | `1.82.0` | [`anthropic`](https://rubygems.org/gems/anthropic) |
69
70The same versions are available as JSON at `https://platform.claude.com/docs/sdk-versions.json`.
71
5772## Libraries and integrations
5873
5974Libraries and integrations expose Claude through another framework's API surface. They are not general-purpose Messages API clients.
manage-claude/opentelemetry/api Changed · +11 / -8 lines
from line 59
5959
6060### Admin API and CLI
6161
62You can also add a destination with the [Admin API](https://platform.claude.com/docs/en/manage-claude/admin-api) instead of the Console. Sign in to the CLI as an admin, or use an [Admin API key](https://platform.claude.com/docs/en/manage-claude/admin-api-keys) in `ANTHROPIC_API_KEY`. On Claude Platform on AWS, send the requests to `https://aws-external-anthropic.{region}.api.aws` instead, signed with your AWS credentials as in [Making requests](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#making-requests). There, your [IAM policy](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions) determines who can manage destinations. A request can include only the workspaces of your AWS account in that Region.
62You can also add a destination with the [Admin API](https://platform.claude.com/docs/en/manage-claude/admin-api) instead of the Console. Sign in to the CLI as an admin, or use another [Admin API credential](https://platform.claude.com/docs/en/manage-claude/admin-api#authentication), such as an [Admin API key](https://platform.claude.com/docs/en/manage-claude/admin-api-keys) or a service account key in `ANTHROPIC_API_KEY`. On Claude Platform on AWS, send the requests to `https://aws-external-anthropic.{region}.api.aws` instead, signed with your AWS credentials as in [Making requests](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#making-requests). There, your [IAM policy](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions) determines who can manage destinations. A request can include only the workspaces of your AWS account in that Region.
6363
6464<CodeGroup>
6565 ```bash CLI
from line 619
619619 </Tab>
620620</Tabs>
621621
622The Messages API also passes the trace on to your MCP server when you connect it with the [MCP connector](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector), so that it can put its own spans under the API spans. Each request and notification that the API sends to your MCP server has a W3C `traceparent` in `params._meta`. In a `tools/call` request, it references the [`anthropic.mcp_tool_use`](https://platform.claude.com/docs/en/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) span of that tool use. In the other messages, it references the [`anthropic.messages.create`](https://platform.claude.com/docs/en/api/opentelemetry/spans#anthropic-messages-create) span. For a request that the API doesn't trace, such as one whose `traceparent` header has the sampled flag off, the API sends no `traceparent`.
622When you connect your MCP server with the [Messages API's MCP connector](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector) or the [Managed Agents MCP connector](https://platform.claude.com/docs/en/managed-agents/mcp-connector), the API also passes the trace on to your server. The server can then put its own spans under the API spans. In `params._meta` of a `tools/call` request, the API sends a W3C `traceparent` that references the [`anthropic.mcp_tool_use`](https://platform.claude.com/docs/en/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) span for that tool use. With the Messages API's MCP connector, the other requests and notifications to your MCP server have a `traceparent` too, which references the [`anthropic.messages.create`](https://platform.claude.com/docs/en/api/opentelemetry/spans#anthropic-messages-create) span. If the API doesn't trace your Messages API request, such as when its `traceparent` header has the sampled flag off, your MCP server gets no `traceparent`.
623623
624624## Next steps
625625
from line 639
639639
640640* **At least once:** A destination can receive the same span more than once. To remove duplicates, use the trace ID and span ID.
641641* **Best effort:** A span can be lost before delivery. The API can't send a lost span again.
642* **Compression:** The API compresses every delivery's first request with gzip and sets the header `Content-Encoding: gzip`. If your endpoint answers that request with a `400` or `415` response, the API sends the same spans again right away without compression.
643* **Retries:** The API retries a delivery later, a limited number of times, after a timeout, a connection, TLS, or DNS failure, or a `408`, `429`, or `5xx` response. It doesn't retry other failures.
644* **Timeouts:** For each request, your endpoint must complete the TLS handshake within 5 seconds and send the response headers within 5 seconds. Each delivery times out after 10 seconds in total, including the resend without compression.
642* **Compression:** The API compresses requests with gzip and sets the header `Content-Encoding: gzip`. If your endpoint answers a compressed request with a `400`, `406`, `415`, or `422` response, the API sends the same spans again right away without compression. It then usually sends that destination's later requests without compression for about a day.
643* **Retries:** The API retries a delivery later, a limited number of times, after a timeout, a connection, TLS, or DNS failure, an invalid address, or a `408`, `429`, or `5xx` response. It doesn't retry other failures.
644* **Timeouts:** For each request, your endpoint must complete the TLS handshake within 5 seconds and send the response headers within 5 seconds. Each delivery times out after 10 seconds in total, including any resend.
645645* **User agent:** Each request has the header `User-Agent: Claude-Platform`.
646646
647647The **Delivery** column shows each destination's state. The state can be up to a minute late.
from line 656
656656The API disables a destination when:
657657
658658* The endpoint sends a `3xx` redirect.
659* The endpoint's hostname resolves to an IP address that isn't public.
660659* All deliveries fail for 24 hours.
661660
662The API doesn't send spans to a disabled destination. To resume export, fix the cause. Then, on the [OpenTelemetry settings page](https://platform.claude.com/settings/telemetry-destinations) in the Console, click **Enable** in the destination's **More actions** menu while the **Workspace** filter shows **All**. Export starts again within about a minute.
661While a destination is disabled, the API drops the spans for it, and they aren't sent after you enable it again. To resume export, fix the cause and check the fix with **Test** in the destination's **More actions** menu. Then, on the [OpenTelemetry settings page](https://platform.claude.com/settings/telemetry-destinations) in the Console, click **Enable** in the same menu while the **Workspace** filter shows **All**. Export starts again within about a minute. Until the next delivery, the **Delivery** column can still show **Failing** with the old error.
663662
664663To change a destination, open its **More actions** menu while the **Workspace** filter shows **All**. Then click **Edit**, **Disable**, **Enable**, or **Delete**. If you change the host of the **OTLP endpoint URL**, enter the header values again. If the destination has an **OTLP traces endpoint URL**, give it the same new host, or clear it.
665664
from line 691
692691| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
693692| HTTP error (status 401) or HTTP error (status 403) | A wrong authentication header |
694693| HTTP error (status 404) | A wrong path in the **OTLP endpoint URL** or the **OTLP traces endpoint URL** |
695| DNS resolution failure | The endpoint's hostname doesn't resolve |
694| Invalid address | The endpoint's hostname doesn't exist or doesn't resolve to a public IP address |
695| Temporary DNS failure | The DNS lookup of the endpoint's hostname failed, for example because its DNS server returned an error |
696696| TLS failure | A TLS problem, for example with the endpoint's certificate |
697697| Timeout | The endpoint didn't respond in time. See [the delivery timeouts](https://platform.claude.com/docs/en/manage-claude/opentelemetry/api#delivery-and-health) |
698698| Connection failure | The API couldn't connect to the endpoint |
699| Redirect (status 3xx) | The endpoint redirected the request. The API doesn't follow redirects, so use the URL it redirects to |
700| HTTP error (status 408, 429, or 5xx) | The endpoint was overloaded, limited the rate of requests, or had an error |
701| HTTP error (another 4xx status) | The endpoint refused the request, for example because of its size or format |
699702
api/beta/messages/batches Changed · +1 / -1 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 133
133133
134134- `"anthropic-user-profile-id": optional string`
135135
136 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
136 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
137137
138138- `"anthropic-workspace-id": optional string`
139139
from line 7324
73247324
73257325 - `name: "memory"`
73267326
7327 Name of the
7327 Name of the tool.
7328
7329 This is
api/beta/messages/batches/create Changed · +1 / -1 lines
from line 131
131131
132132- `"anthropic-user-profile-id": optional string`
133133
134 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
134 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
135135
136136- `"anthropic-workspace-id": optional string`
137137
api/beta/messages/count_tokens Changed · +1 / -1 lines
from line 131
131131
132132- `"anthropic-user-profile-id": optional string`
133133
134 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
134 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization.
135135
136136- `"anthropic-workspace-id": optional string`
137137
api/beta/messages/create Changed · +1 / -1 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 131
131131
132132- `"anthropic-user-profile-id": optional string`
133133
134 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
134 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization.
135135
136136- `"anthropic-workspace-id": optional string`
137137
from line 7158
71587158
71597159 This is how the tool will be called by the model and in `tool_use` blocks.
71607160
7161 - `allow
7161 - `allowed_callers: optional array of "direct" or
api/beta/user_profiles/create_enrollment_url Changed · +2 / -2 lines
from line 25
2525
2626- `"anthropic-beta": optional array of AnthropicBeta`
2727
28 This endpoint is in beta: requests must send `user-profiles-2026-03-24`, `user-profiles-2026-08-18`, or `user-profiles-2026-09-04` in this header.
28 Optional header to specify the beta version(s) you want to use.
2929
3030 - `string`
3131
from line 141
141141
142142- `BetaUserProfileEnrollmentURL object`
143143
144 A URL to give to the entity that a user profile represents, so that the entity can enroll for a trust grant.
144 A URL to give to the entity that a user profile represents, so that the entity can enroll in a program.
145145
146146 - `type: "enrollment_url"`
147147
api/messages/batches Changed · +1 / -1 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 25
2525
2626- `"anthropic-user-profile-id": optional string`
2727
28 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
28 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
2929
3030- `"anthropic-workspace-id": optional string`
3131
from line 8641
86418641
86428642 - `TextEditorCodeExecutionToolResultError object`
86438643
8644 - `type: "text_e
8644 - `type: "text_editor_code_execution_tool_result_error"`
8645
8646
api/messages/batches/create Changed · +1 / -1 lines
from line 23
2323
2424- `"anthropic-user-profile-id": optional string`
2525
26 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
26 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
2727
2828- `"anthropic-workspace-id": optional string`
2929
api/messages/count_tokens Changed · +1 / -1 lines
from line 23
2323
2424- `"anthropic-user-profile-id": optional string`
2525
26 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
26 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization.
2727
2828- `"anthropic-workspace-id": optional string`
2929
api/messages/create Changed · +1 / -1 lines
from line 23
2323
2424- `"anthropic-user-profile-id": optional string`
2525
26 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
26 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization.
2727
2828- `"anthropic-workspace-id": optional string`
2929
cli-sdks-libraries/cli/quickstart Changed · +1 / -1 lines
from line 32
3232 For Linux environments, download the release binary directly.
3333
3434 ```bash
35 VERSION=1.43.0
35 VERSION=1.44.0
3636 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
3737 case $(uname -m) in
3838 x86_64) ARCH=amd64 ;;
cli-sdks-libraries/sdks/java Changed · +2 / -2 lines
from line 15
1515<Tabs>
1616 <Tab title="Gradle">
1717 ```kotlin
18 implementation("com.anthropic:anthropic-java:2.74.0")
18 implementation("com.anthropic:anthropic-java:2.75.0")
1919 ```
2020 </Tab>
2121
from line 24
2424 <dependency>
2525 <groupId>com.anthropic</groupId>
2626 <artifactId>anthropic-java</artifactId>
27 <version>2.74.0</version>
27 <version>2.75.0</version>
2828 </dependency>
2929 ```
3030 </Tab>
get-started Changed · +2 / -2 lines
from line 436
436436 }
437437
438438 dependencies {
439 implementation("com.anthropic:anthropic-java:2.74.0")
439 implementation("com.anthropic:anthropic-java:2.75.0")
440440 }
441441
442442 application {
from line 462
462462 <dependency>
463463 <groupId>com.anthropic</groupId>
464464 <artifactId>anthropic-java</artifactId>
465 <version>2.74.0</version>
465 <version>2.75.0</version>
466466 </dependency>
467467 </dependencies>
468468 </project>
manage-claude/inference-hooks Changed · +1 / -1 lines
from line 79
7979
8080One hook governs conversations across all Claude products in your Claude Enterprise organization, including, but not limited to, claude.ai, Cowork, Claude Code, Claude for Microsoft 365, Claude Tag, and Claude in Chrome, whether they run on the web, in the desktop or mobile apps, in the CLI, or in Slack. Inference hooks are not available on Amazon Bedrock or Google Cloud.
8181
82Governed requests are the inference requests behind the user's conversation or session. System prompts and tool definitions are never included in what is sent. In voice mode, prompts and tool calls are sent to your endpoint too, though a small share of tool calls isn't, so don't rely on inference hooks as your only control for voice. If your endpoint denies a request in voice mode, the voice call usually ends with a general error message, and your deny reason isn't shown.
82Governed requests are the inference requests behind the user's conversation or session. System prompts and tool definitions are never included in what is sent. In voice mode, prompts and tool calls are sent to your endpoint too, though a small share of tool calls isn't, so don't rely on Inference hooks as your only control for voice. If your endpoint denies a request in voice mode, the voice call usually ends with a general error message, and your deny reason isn't shown.
8383
8484With **Validate tool calls** on, `tool_call` events may leave out calls to some of claude.ai's own tools, such as tools that list, search for, or suggest connectors, plugins, or skills, suggest starting research or turning on web search, search for other tools, switch to a larger model, end the chat, give Claude the user's local time, or read the user's own past chats and saved memory. These calls and their results stay in the conversation, so the next `prompt` event from that conversation, if there is one, includes them.
8585
manage-claude/opentelemetry/sdk Changed · +2 / -2 lines
from line 84
8484
8585 <CodeGroup exclude="shell, python, typescript, csharp, go, php, ruby">
8686 ```kotlin Gradle
87 implementation("com.anthropic:anthropic-java:2.74.0")
87 implementation("com.anthropic:anthropic-java:2.75.0")
8888 ```
8989
9090 ```xml Maven
from line 91
9191 <dependency>
9292 <groupId>com.anthropic</groupId>
9393 <artifactId>anthropic-java</artifactId>
94 <version>2.74.0</version>
94 <version>2.75.0</version>
9595 </dependency>
9696 ```
9797 </CodeGroup>
managed-agents/quickstart Changed · +2 / -2 lines
from line 49
4949 For Linux environments, download the release binary directly.
5050
5151 ```bash
52 VERSION=1.43.0
52 VERSION=1.44.0
5353 OS=$(uname -s | tr '[:upper:]' '[:lower:]')
5454 case $(uname -m) in
5555 x86_64) ARCH=amd64 ;;
from line 100
100100
101101 <Tab title="Java">
102102 ```groovy Gradle
103 implementation("com.anthropic:anthropic-java:2.74.0")
103 implementation("com.anthropic:anthropic-java:2.75.0")
104104 ```
105105 </Tab>
106106
managed-agents/self-hosted-sandboxes-workers Changed · +1 / -1 lines
from line 437
437437
438438 ```dockerfile
439439 FROM your-base-image
440 ARG ANT_VERSION=1.43.0
440 ARG ANT_VERSION=1.44.0
441441 ARG TARGETARCH
442442 RUN ARCH=$([ "$TARGETARCH" = "arm64" ] && echo arm64 || echo amd64) && \
443443 curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${ANT_VERSION}/ant_${ANT_VERSION}_linux_${ARCH}.tar.gz" \