anthropic 0.69.0__py3-none-any.whl → 0.71.0__py3-none-any.whl

anthropic/resources/messages/messages.py

@@ -127,7 +127,7 @@ class Messages(SyncAPIResource):
               only specifies the absolute maximum number of tokens to generate.
 
               Different models have different maximum values for this parameter. See
-              [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+              [models](https://docs.claude.com/en/docs/models-overview) for details.
 
           messages: Input messages.
 
@@ -186,12 +186,12 @@ class Messages(SyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -205,7 +205,7 @@ class Messages(SyncAPIResource):
               for this request.
 
               Anthropic offers different levels of service for your API requests. See
-              [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
 
           stop_sequences: Custom text sequences that will cause the model to stop generating.
 
@@ -219,14 +219,13 @@ class Messages(SyncAPIResource):
 
           stream: Whether to incrementally stream the response using server-sent events.
 
-              See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-              details.
+              See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
 
           system: System prompt.
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           temperature: Amount of randomness injected into the response.
 
@@ -244,7 +243,7 @@ class Messages(SyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -259,9 +258,9 @@ class Messages(SyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -324,7 +323,7 @@ class Messages(SyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           top_k: Only sample from the top K options for each subsequent token.
 
@@ -395,7 +394,7 @@ class Messages(SyncAPIResource):
               only specifies the absolute maximum number of tokens to generate.
 
               Different models have different maximum values for this parameter. See
-              [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+              [models](https://docs.claude.com/en/docs/models-overview) for details.
 
           messages: Input messages.
 
@@ -454,12 +453,12 @@ class Messages(SyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -469,8 +468,7 @@ class Messages(SyncAPIResource):
 
           stream: Whether to incrementally stream the response using server-sent events.
 
-              See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-              details.
+              See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
 
           metadata: An object describing metadata about the request.
 
@@ -478,7 +476,7 @@ class Messages(SyncAPIResource):
               for this request.
 
               Anthropic offers different levels of service for your API requests. See
-              [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
 
           stop_sequences: Custom text sequences that will cause the model to stop generating.
 
@@ -494,7 +492,7 @@ class Messages(SyncAPIResource):
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           temperature: Amount of randomness injected into the response.
 
@@ -512,7 +510,7 @@ class Messages(SyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -527,9 +525,9 @@ class Messages(SyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -592,7 +590,7 @@ class Messages(SyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           top_k: Only sample from the top K options for each subsequent token.
 
@@ -663,7 +661,7 @@ class Messages(SyncAPIResource):
               only specifies the absolute maximum number of tokens to generate.
 
               Different models have different maximum values for this parameter. See
-              [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+              [models](https://docs.claude.com/en/docs/models-overview) for details.
 
           messages: Input messages.
 
@@ -722,12 +720,12 @@ class Messages(SyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -737,8 +735,7 @@ class Messages(SyncAPIResource):
 
           stream: Whether to incrementally stream the response using server-sent events.
 
-              See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-              details.
+              See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
 
           metadata: An object describing metadata about the request.
 
@@ -746,7 +743,7 @@ class Messages(SyncAPIResource):
               for this request.
 
               Anthropic offers different levels of service for your API requests. See
-              [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
 
           stop_sequences: Custom text sequences that will cause the model to stop generating.
 
@@ -762,7 +759,7 @@ class Messages(SyncAPIResource):
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           temperature: Amount of randomness injected into the response.
 
@@ -780,7 +777,7 @@ class Messages(SyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -795,9 +792,9 @@ class Messages(SyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -860,7 +857,7 @@ class Messages(SyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           top_k: Only sample from the top K options for each subsequent token.
 
@@ -1109,12 +1106,12 @@ class Messages(SyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -1126,7 +1123,7 @@ class Messages(SyncAPIResource):
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           thinking: Configuration for enabling Claude's extended thinking.
 
@@ -1135,7 +1132,7 @@ class Messages(SyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -1150,9 +1147,9 @@ class Messages(SyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -1215,7 +1212,7 @@ class Messages(SyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           extra_headers: Send extra headers
 
@@ -1310,7 +1307,7 @@ class AsyncMessages(AsyncAPIResource):
               only specifies the absolute maximum number of tokens to generate.
 
               Different models have different maximum values for this parameter. See
-              [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+              [models](https://docs.claude.com/en/docs/models-overview) for details.
 
           messages: Input messages.
 
@@ -1369,12 +1366,12 @@ class AsyncMessages(AsyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -1388,7 +1385,7 @@ class AsyncMessages(AsyncAPIResource):
               for this request.
 
               Anthropic offers different levels of service for your API requests. See
-              [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
 
           stop_sequences: Custom text sequences that will cause the model to stop generating.
 
@@ -1402,14 +1399,13 @@ class AsyncMessages(AsyncAPIResource):
 
           stream: Whether to incrementally stream the response using server-sent events.
 
-              See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-              details.
+              See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
 
           system: System prompt.
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           temperature: Amount of randomness injected into the response.
 
@@ -1427,7 +1423,7 @@ class AsyncMessages(AsyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -1442,9 +1438,9 @@ class AsyncMessages(AsyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -1507,7 +1503,7 @@ class AsyncMessages(AsyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           top_k: Only sample from the top K options for each subsequent token.
 
@@ -1578,7 +1574,7 @@ class AsyncMessages(AsyncAPIResource):
               only specifies the absolute maximum number of tokens to generate.
 
               Different models have different maximum values for this parameter. See
-              [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+              [models](https://docs.claude.com/en/docs/models-overview) for details.
 
           messages: Input messages.
 
@@ -1637,12 +1633,12 @@ class AsyncMessages(AsyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -1652,8 +1648,7 @@ class AsyncMessages(AsyncAPIResource):
 
           stream: Whether to incrementally stream the response using server-sent events.
 
-              See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-              details.
+              See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
 
           metadata: An object describing metadata about the request.
 
@@ -1661,7 +1656,7 @@ class AsyncMessages(AsyncAPIResource):
               for this request.
 
               Anthropic offers different levels of service for your API requests. See
-              [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
 
           stop_sequences: Custom text sequences that will cause the model to stop generating.
 
@@ -1677,7 +1672,7 @@ class AsyncMessages(AsyncAPIResource):
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           temperature: Amount of randomness injected into the response.
 
@@ -1695,7 +1690,7 @@ class AsyncMessages(AsyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -1710,9 +1705,9 @@ class AsyncMessages(AsyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -1775,7 +1770,7 @@ class AsyncMessages(AsyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           top_k: Only sample from the top K options for each subsequent token.
 
@@ -1846,7 +1841,7 @@ class AsyncMessages(AsyncAPIResource):
               only specifies the absolute maximum number of tokens to generate.
 
               Different models have different maximum values for this parameter. See
-              [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+              [models](https://docs.claude.com/en/docs/models-overview) for details.
 
           messages: Input messages.
 
@@ -1905,12 +1900,12 @@ class AsyncMessages(AsyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -1920,8 +1915,7 @@ class AsyncMessages(AsyncAPIResource):
 
           stream: Whether to incrementally stream the response using server-sent events.
 
-              See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-              details.
+              See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
 
           metadata: An object describing metadata about the request.
 
@@ -1929,7 +1923,7 @@ class AsyncMessages(AsyncAPIResource):
               for this request.
 
               Anthropic offers different levels of service for your API requests. See
-              [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+              [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
 
           stop_sequences: Custom text sequences that will cause the model to stop generating.
 
@@ -1945,7 +1939,7 @@ class AsyncMessages(AsyncAPIResource):
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           temperature: Amount of randomness injected into the response.
 
@@ -1963,7 +1957,7 @@ class AsyncMessages(AsyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -1978,9 +1972,9 @@ class AsyncMessages(AsyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -2043,7 +2037,7 @@ class AsyncMessages(AsyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           top_k: Only sample from the top K options for each subsequent token.
 
@@ -2291,12 +2285,12 @@ class AsyncMessages(AsyncAPIResource):
               { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
               ```
 
-              See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+              See [input examples](https://docs.claude.com/en/api/messages-examples).
 
               Note that if you want to include a
-              [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-              the top-level `system` parameter — there is no `"system"` role for input
-              messages in the Messages API.
+              [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+              top-level `system` parameter — there is no `"system"` role for input messages in
+              the Messages API.
 
               There is a limit of 100,000 messages in a single request.
 
@@ -2308,7 +2302,7 @@ class AsyncMessages(AsyncAPIResource):
 
               A system prompt is a way of providing context and instructions to Claude, such
               as specifying a particular goal or role. See our
-              [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+              [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
 
           thinking: Configuration for enabling Claude's extended thinking.
 
@@ -2317,7 +2311,7 @@ class AsyncMessages(AsyncAPIResource):
               tokens and counts towards your `max_tokens` limit.
 
               See
-              [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+              [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
               for details.
 
           tool_choice: How the model should use the provided tools. The model can use a specific tool,
@@ -2332,9 +2326,9 @@ class AsyncMessages(AsyncAPIResource):
 
               There are two types of tools: **client tools** and **server tools**. The
               behavior described below applies to client tools. For
-              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
               see their individual documentation as each has its own behavior (e.g., the
-              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+              [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
               Each tool definition includes:
 
@@ -2397,7 +2391,7 @@ class AsyncMessages(AsyncAPIResource):
               functions, or more generally whenever you want the model to produce a particular
               JSON structure of output.
 
-              See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+              See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
 
           extra_headers: Send extra headers
 

anthropic/types/anthropic_beta_param.py

@@ -25,5 +25,8 @@ AnthropicBetaParam: TypeAlias = Union[
         "code-execution-2025-05-22",
         "extended-cache-ttl-2025-04-11",
         "context-1m-2025-08-07",
+        "context-management-2025-06-27",
+        "model-context-window-exceeded-2025-08-26",
+        "skills-2025-10-02",
     ],
 ]

anthropic/types/beta/__init__.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from .beta_skill import BetaSkill as BetaSkill
 from .beta_usage import BetaUsage as BetaUsage
 from .beta_message import BetaMessage as BetaMessage
 from .deleted_file import DeletedFile as DeletedFile
@@ -13,7 +14,9 @@ from .beta_text_delta import BetaTextDelta as BetaTextDelta
 from .beta_tool_param import BetaToolParam as BetaToolParam
 from .beta_stop_reason import BetaStopReason as BetaStopReason
 from .file_list_params import FileListParams as FileListParams
+from .beta_skill_params import BetaSkillParams as BetaSkillParams
 from .model_list_params import ModelListParams as ModelListParams
+from .skill_list_params import SkillListParams as SkillListParams
 from .beta_content_block import BetaContentBlock as BetaContentBlock
 from .beta_message_param import BetaMessageParam as BetaMessageParam
 from .beta_text_citation import BetaTextCitation as BetaTextCitation
@@ -24,20 +27,26 @@ from .beta_metadata_param import BetaMetadataParam as BetaMetadataParam
 from .beta_thinking_block import BetaThinkingBlock as BetaThinkingBlock
 from .beta_thinking_delta import BetaThinkingDelta as BetaThinkingDelta
 from .beta_tool_use_block import BetaToolUseBlock as BetaToolUseBlock
+from .skill_create_params import SkillCreateParams as SkillCreateParams
+from .skill_list_response import SkillListResponse as SkillListResponse
 from .beta_citation_config import BetaCitationConfig as BetaCitationConfig
 from .beta_citations_delta import BetaCitationsDelta as BetaCitationsDelta
 from .beta_signature_delta import BetaSignatureDelta as BetaSignatureDelta
 from .beta_web_fetch_block import BetaWebFetchBlock as BetaWebFetchBlock
+from .beta_container_params import BetaContainerParams as BetaContainerParams
 from .beta_input_json_delta import BetaInputJSONDelta as BetaInputJSONDelta
 from .beta_text_block_param import BetaTextBlockParam as BetaTextBlockParam
 from .beta_tool_union_param import BetaToolUnionParam as BetaToolUnionParam
 from .message_create_params import MessageCreateParams as MessageCreateParams
+from .skill_create_response import SkillCreateResponse as SkillCreateResponse
+from .skill_delete_response import SkillDeleteResponse as SkillDeleteResponse
 from .beta_base64_pdf_source import BetaBase64PDFSource as BetaBase64PDFSource
 from .beta_image_block_param import BetaImageBlockParam as BetaImageBlockParam
 from .beta_plain_text_source import BetaPlainTextSource as BetaPlainTextSource
 from .beta_server_tool_usage import BetaServerToolUsage as BetaServerToolUsage
 from .beta_tool_choice_param import BetaToolChoiceParam as BetaToolChoiceParam
 from .beta_mcp_tool_use_block import BetaMCPToolUseBlock as BetaMCPToolUseBlock
+from .skill_retrieve_response import SkillRetrieveResponse as SkillRetrieveResponse
 from .beta_content_block_param import BetaContentBlockParam as BetaContentBlockParam
 from .beta_message_delta_usage import BetaMessageDeltaUsage as BetaMessageDeltaUsage
 from .beta_text_citation_param import BetaTextCitationParam as BetaTextCitationParam