One read of Claude Developer Platformapi-20261030T212610Z
396 pages moved out of 826 read.
Pages moved
396
significant first
Pages read
826
in this capture
Captured
21:26 UTC
Corpus hash
68200c8a9acb
corpus-hash
What this read moved
376-396 of 396, page 16 of 16This capture is too large to show at once. Changes 376-396 of 396 are below, significant first; the rest are on the following screens.
api/organization/api_keys/retrieve Changed · +2 / -2 lines
from line 156
156156 "id": "apikey_01Rj2N8SVvo6BePZj99NhmiT",
157157 "created_at": "2024-10-30T23:58:27.427722Z",
158158 "created_by": {
159 "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
159 "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
160160 "type": "user"
161161 },
162162 "expires_at": "2024-10-30T23:58:27.427722Z",
from line 164
164164 "partial_key_hint": "sk-ant-api03-R2D...igAA",
165165 "principal": {
166166 "type": "user_actor",
167 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
167 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
168168 },
169169 "scope": {
170170 "type": "workspace",
api/organization/api_keys/update Changed · +2 / -2 lines
from line 176
176176 "id": "apikey_01Rj2N8SVvo6BePZj99NhmiT",
177177 "created_at": "2024-10-30T23:58:27.427722Z",
178178 "created_by": {
179 "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
179 "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
180180 "type": "user"
181181 },
182182 "expires_at": "2024-10-30T23:58:27.427722Z",
from line 184
184184 "partial_key_hint": "sk-ant-api03-R2D...igAA",
185185 "principal": {
186186 "type": "user_actor",
187 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
187 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
188188 },
189189 "scope": {
190190 "type": "workspace",
api/organization/users/list Changed · +1 / -1 lines
from line 125
125125{
126126 "data": [
127127 {
128 "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
128 "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
129129 "added_at": "2024-10-30T23:58:27.427722Z",
131131 "name": "Jane Doe",
api/organization/users/remove Changed · +1 / -1 lines
from line 50
5050
5151```json
5252{
53 "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
53 "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
5454 "type": "user_deleted"
5555}
5656```
api/organization/users/retrieve Changed · +1 / -1 lines
from line 87
8787
8888```json
8989{
90 "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
90 "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
9191 "added_at": "2024-10-30T23:58:27.427722Z",
9393 "name": "Jane Doe",
api/organization/users/update Changed · +1 / -1 lines
from line 109
109109
110110```json
111111{
112 "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
112 "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
113113 "added_at": "2024-10-30T23:58:27.427722Z",
115115 "name": "Jane Doe",
api/organization/workspaces/members/add Changed · +2 / -2 lines
from line 83
8383 -H 'anthropic-version: 2026-10-21' \
8484 -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
8585 -d '{
86 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
86 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
8787 "workspace_role": "workspace_admin"
8888 }'
8989```
from line 93
9393```json
9494{
9595 "type": "workspace_member",
96 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
96 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
9797 "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
9898 "workspace_role": "workspace_admin"
9999}
api/organization/workspaces/members/list Changed · +1 / -1 lines
from line 102
102102 "data": [
103103 {
104104 "type": "workspace_member",
105 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
105 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
106106 "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
107107 "workspace_role": "workspace_admin"
108108 }
api/organization/workspaces/members/remove Changed · +1 / -1 lines
from line 59
5959```json
6060{
6161 "type": "workspace_member_deleted",
62 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
62 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
6363 "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
6464}
6565```
api/organization/workspaces/members/retrieve Changed · +1 / -1 lines
from line 74
7474```json
7575{
7676 "type": "workspace_member",
77 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
77 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
7878 "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
7979 "workspace_role": "workspace_admin"
8080}
api/organization/workspaces/members/update Changed · +1 / -1 lines
from line 94
9494```json
9595{
9696 "type": "workspace_member",
97 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
97 "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
9898 "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
9999 "workspace_role": "workspace_admin"
100100}
build-with-claude/context-windows Changed · +2 / -2 lines
from line 14
1414 For more on why long contexts degrade and how to engineer around it, see [Effective context engineering](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents).
1515</Tip>
1616
17The following diagram illustrates the standard context window behavior for API requests1:
17The following diagram illustrates the standard context window behavior for API requests<sup>1</sup>:
1818
1919<Frame>
2020 
2121</Frame>
2222
23*1 Chat interfaces such as [claude.ai](https://claude.ai/) can also manage the context window on a rolling “first in, first out” basis.*
23*<sup>1</sup> Chat interfaces such as [claude.ai](https://claude.ai/) can also manage the context window on a rolling “first in, first out” basis.*
2424
2525* **Progressive token accumulation:** As the conversation advances through turns, each user message and assistant response accumulates within the context window, and previous turns are preserved completely.
2626
build-with-claude/prompt-engineering/claude-prompting-best-practices Changed · +1 / -1 lines
from line 1070
10701070
10711071If people might ask your application about medicine doses, add the block below for the model your application calls to your system prompt, exactly as written. The block has Claude give a child’s dose of an over-the-counter medicine from the product’s label, not from memory. With web search, such as the [web search tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool), Claude checks the label before answering, which adds latency and search costs. Without web search, Claude points the person to the label’s dosing chart, a pharmacist, or the child’s doctor instead of giving a dose.
10721072
1073```text Medication dosing block for Claude Sonnet 5.5 wrap
1073```text Medication dosing block for Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, and Claude Sonnet 5 wrap
10741074<medical_guidance>
10751075This applies only when the person explicitly says the medicine is for a child, and isn't a healthcare professional asking for work.
10761076Dosing for children's over-the-counter medicines depends on the child's weight and the specific product. For infants and toddlers, a small error can cause real harm. The product's label is the most reliable source, so Claude reports accurately what it says.
build-with-claude/search-results Changed · +1 / -1 lines
from line 50
50501. **From tool calls:** Your custom tools return search results, which lets you build dynamic RAG applications.
51512. **As top-level content:** You provide search results directly in user messages for pre-fetched or cached content.
5252
53In both cases, Claude cites the search results automatically when citations are enabled. No special prompting is needed: ask your question, and citations appear on the text blocks that draw on your content.
53In both cases, Claude cites the search results automatically when citations are enabled. No special prompting is needed: ask your question, and citations appear on the text blocks that draw on your content. However, if your prompt asks for only JSON, the response might contain few or no citations. To extract structured data with a citation for each value, see [Get structured data with citations](https://platform.claude.com/docs/en/build-with-claude/citations#get-structured-data-with-citations).
5454
5555### Search result schema
5656
build-with-claude/structured-outputs Changed · +1 / -1 lines
from line 2798
27982798
27992799**Incompatible with:**
28002800
2801* **[Citations](https://platform.claude.com/docs/en/build-with-claude/citations):** Citations require interleaving citation blocks with text, which conflicts with strict JSON schema constraints. The API returns a 400 error if citations are enabled with `output_config.format`.
2801* **[Citations](https://platform.claude.com/docs/en/build-with-claude/citations):** Citations require interleaving citation blocks with text, which conflicts with strict JSON schema constraints. The API returns a 400 error if citations are enabled with `output_config.format`. To extract structured data with a citation for each value, see [Get structured data with citations](https://platform.claude.com/docs/en/build-with-claude/citations#get-structured-data-with-citations).
28022802* **Message prefilling:** Prefilling is incompatible with JSON outputs.
28032803
28042804<Tip>
manage-claude/admin-api Changed · +1 / -1 lines
from line 1725
17251725
17261726## Rate limits
17271727
1728Read the rate limits configured for your organization and its workspaces with the [Rate Limits API](https://platform.claude.com/docs/en/manage-claude/rate-limits-api).
1728Read the rate limits configured for your organization and its workspaces, and set workspace rate limits, with the [Rate Limits API](https://platform.claude.com/docs/en/manage-claude/rate-limits-api).
17291729
17301730## Compliance API
17311731
manage-claude/cmek-key-lifecycle Changed · +2 / -2 lines
from line 28
2828
2929## If Anthropic can’t reach your key
3030
31Requests that store data under your key fail while Anthropic can’t reach it, for example during an outage of your KMS. On Claude Enterprise, these requests include messages in chat and in voice mode.
31An outage of your KMS, for example, can stop Anthropic from reaching your key. When that happens, requests that store data under your key might still succeed for up to 1 hour. After that, they fail until Anthropic can reach your key again. On Claude Enterprise, these requests include messages in chat and in voice mode.
3232
33On the Messages API, these requests return a 503 error with the code `cmek_key_unreachable`, and you can retry them. The Message Batches API retries them for you until your key is available or the batch expires.
33On the Messages API, requests that fail this way return a 503 error with the code `cmek_key_unreachable`, and you can retry them. The Message Batches API retries them for you until your key is available or the batch expires.
3434
3535## Change keys or stop using CMEK
3636
manage-claude/plugins-api Changed · +2 / -2 lines
from line 347
347347* File paths must be relative, contain no `..`, and use only letters, digits, spaces, and `_ . - / ( ) ,`.
348348* The request body and the uncompressed archive are each at most 200 MB; a request body over the limit returns `413` (`request_too_large`) rather than `400`. An upload has at most 5,000 files, a path depth of 12, paths of 472 characters, and file or folder names of 255 characters.
349349* ZIP archives must use DEFLATE or STORE compression, and cannot be encrypted or contain symbolic links.
350* A marketplace holds at most 500 items, counting its plugins and any standalone skills members keep in it. This limit and the 5,000-file limit are current values that may be raised.
350* An upload that creates a plugin is refused once the marketplace holds 1,000 items. This total includes its plugins and any skills members keep in it. Anthropic can raise this limit and the 5,000-file limit.
351351
352352## Example workflows
353353
from line 1046
10461046| Status | Cause | What to do |
10471047| -------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
10481048| 404 | `marketplace_id` is not a marketplace of your organization. | Take the ID from [List marketplaces](https://platform.claude.com/docs/en/manage-claude/plugins-api#list-marketplaces). |
1049| 400 | The marketplace is synchronized from Git, or already holds 500 plugins and skills. | Upload to a `manual` marketplace, or change the repository instead. |
1049| 400 | The marketplace is synchronized from Git, or already holds 1,000 plugins and skills. | Upload to a `manual` marketplace, or change the repository instead. |
10501050| 409 `plugin_name_taken` | The name is taken in that marketplace. | Upload a version to `details.plugin_id` only if it is the plugin you meant to update, because someone else might have made it. Otherwise, upload under another name (change the manifest `name`). |
10511051| 409 `skill_name_taken` | The plugin is going into the library marketplace and one of its skills has an organization skill’s name. | Rename the skill, or remove the organization skill in claude.ai. |
10521052| 409 (no `error_code`) | Another upload with the same name to the same marketplace is still in progress. | Retry shortly. |
manage-claude/usage-cost-api Changed · +1 / -1 lines
from line 347
347347* [Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) - Optimize costs with caching
348348* [Batch processing](https://platform.claude.com/docs/en/build-with-claude/batch-processing) - 50 percent discount on batch requests
349349* [Rate limits](https://platform.claude.com/docs/en/api/rate-limits) - Understand usage tiers
350* [Rate Limits API](https://platform.claude.com/docs/en/manage-claude/rate-limits-api) - Read your configured rate limits
350* [Rate Limits API](https://platform.claude.com/docs/en/manage-claude/rate-limits-api) - Read your configured rate limits and set workspace rate limits
351351* [Data residency](https://platform.claude.com/docs/en/manage-claude/data-residency) - Control inference geography
352352
manage-claude/workspaces Changed · +1 / -1 lines
from line 1031
10311031 - Organization-wide limits always apply, even if workspace limits add up to more.
10321032</Note>
10331033
1034For detailed information on rate limits and how they work, see [Rate limits](https://platform.claude.com/docs/en/api/rate-limits). You can also read your current organization and workspace rate limits programmatically with the [Rate Limits API](https://platform.claude.com/docs/en/manage-claude/rate-limits-api).
1034For detailed information on rate limits and how they work, see [Rate limits](https://platform.claude.com/docs/en/api/rate-limits). You can also read your current organization and workspace rate limits and set workspace rate limits programmatically with the [Rate Limits API](https://platform.claude.com/docs/en/manage-claude/rate-limits-api), which stores a value above the organization’s limit but still enforces the lower of the two.
10351035
10361036## Usage and cost tracking
10371037
models/opus-5-5/migration-guide Changed · +2 / -2 lines
from line 22
2222
2323Whichever model you are coming from, a request to `claude-opus-5-5` must meet the following. Where an item says a setting is rejected, the API returns a 400 error.
2424
25* **Model ID:** Use `claude-opus-5-5`, a fixed model ID with no date suffix. On Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Google managed), and Microsoft Foundry, use that platform’s model ID; see [Availability](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#availability).
25* **Model ID:** Use `claude-opus-5-5`, a fixed model ID with no date suffix. On Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed), and Microsoft Foundry, use that platform’s model ID; see [Availability](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#availability).
2626* **Thinking:** Send no `thinking` field, or send `thinking: {"type": "adaptive"}`, which is equivalent: [adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/thinking) is always on. `thinking: {"type": "disabled"}` and manual thinking budgets (`thinking: {"type": "enabled", "budget_tokens": N}`) are rejected. See the [before and after for thinking](https://platform.claude.com/docs/en/models/opus-5-5/migration-guide#thinking-cant-be-disabled).
2727* **Effort:** Control thinking depth with the [effort parameter](https://platform.claude.com/docs/en/build-with-claude/effort), the only request parameter that controls it. All five levels (`low`, `medium`, `high`, `xhigh`, `max`) are supported, and the default is `medium`. See [Recommended effort levels for Claude Opus 5.5](https://platform.claude.com/docs/en/build-with-claude/effort#recommended-effort-levels-for-claude-opus-5-5).
2828* **Tool choice:** Use `tool_choice` `{"type": "auto"}` (the default) or `{"type": "none"}`. Forcing a tool call with `{"type": "any"}` or `{"type": "tool", "name": "..."}` is rejected. See the [before and after for tool choice](https://platform.claude.com/docs/en/models/opus-5-5/migration-guide#forced-tool-use).
from line 353
353353model = "claude-opus-5-5" # After
354354```
355355
356`claude-opus-5-5` is a fixed model ID with no date suffix, the same scheme as `claude-opus-5`. On Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Google managed), and Microsoft Foundry, use that platform’s model ID; see [Availability](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#availability).
356`claude-opus-5-5` is a fixed model ID with no date suffix, the same scheme as `claude-opus-5`. On Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed), and Microsoft Foundry, use that platform’s model ID; see [Availability](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#availability).
357357
358358### Breaking changes
359359