feat(api): add support for Managed Agents multiagents and outcomes, webhooks, vault validation

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 91
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic/anthropic-ad9228826393d94e86ecf4c22853ae51b1d4094960c836238b3ab79a1044be32.yml
-openapi_spec_hash: dc43ed54947d427a084a891b7c4a783a
-config_hash: bbf09e23cb2e12b5bb8cbcee3044ceec
+configured_endpoints: 97
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic/anthropic-9f858907356014087c51d59846cd158425826fc558a1683e6ebf49483503cd5e.yml
+openapi_spec_hash: 87cd38428be2fb157f6d79b50c00f573
+config_hash: 0ed9b1770bb175fa6bdc1e4d41afb180

api.md

@@ -544,6 +544,7 @@ Types:
 ```python
 from anthropic.types.beta import (
     BetaManagedAgentsAgent,
+    BetaManagedAgentsAgentReference,
     BetaManagedAgentsAgentToolConfig,
     BetaManagedAgentsAgentToolConfigParams,
     BetaManagedAgentsAgentToolsetDefaultConfig,
@@ -569,6 +570,9 @@ from anthropic.types.beta import (
     BetaManagedAgentsModel,
     BetaManagedAgentsModelConfig,
     BetaManagedAgentsModelConfigParams,
+    BetaManagedAgentsMultiagentCoordinator,
+    BetaManagedAgentsMultiagentCoordinatorParams,
+    BetaManagedAgentsMultiagentSelfParams,
     BetaManagedAgentsSkillParams,
     BetaManagedAgentsURLMCPServerParams,
 )
@@ -629,8 +633,13 @@ from anthropic.types.beta import (
     BetaManagedAgentsFileResourceParams,
     BetaManagedAgentsGitHubRepositoryResourceParams,
     BetaManagedAgentsMemoryStoreResourceParam,
+    BetaManagedAgentsMultiagent,
+    BetaManagedAgentsMultiagentParams,
+    BetaManagedAgentsMultiagentRosterEntryParams,
+    BetaManagedAgentsOutcomeEvaluationResource,
     BetaManagedAgentsSession,
     BetaManagedAgentsSessionAgent,
+    BetaManagedAgentsSessionMultiagentCoordinator,
     BetaManagedAgentsSessionStats,
     BetaManagedAgentsSessionUsage,
 )
@@ -657,6 +666,8 @@ from anthropic.types.beta.sessions import (
     BetaManagedAgentsAgentMessageEvent,
     BetaManagedAgentsAgentThinkingEvent,
     BetaManagedAgentsAgentThreadContextCompactedEvent,
+    BetaManagedAgentsAgentThreadMessageReceivedEvent,
+    BetaManagedAgentsAgentThreadMessageSentEvent,
     BetaManagedAgentsAgentToolResultEvent,
     BetaManagedAgentsAgentToolUseEvent,
     BetaManagedAgentsBase64DocumentSource,
@@ -666,6 +677,8 @@ from anthropic.types.beta.sessions import (
     BetaManagedAgentsEventParams,
     BetaManagedAgentsFileDocumentSource,
     BetaManagedAgentsFileImageSource,
+    BetaManagedAgentsFileRubric,
+    BetaManagedAgentsFileRubricParams,
     BetaManagedAgentsImageBlock,
     BetaManagedAgentsMCPAuthenticationFailedError,
     BetaManagedAgentsMCPConnectionFailedError,
@@ -687,16 +700,28 @@ from anthropic.types.beta.sessions import (
     BetaManagedAgentsSessionStatusRescheduledEvent,
     BetaManagedAgentsSessionStatusRunningEvent,
     BetaManagedAgentsSessionStatusTerminatedEvent,
+    BetaManagedAgentsSessionThreadCreatedEvent,
+    BetaManagedAgentsSessionThreadStatusIdleEvent,
+    BetaManagedAgentsSessionThreadStatusRescheduledEvent,
+    BetaManagedAgentsSessionThreadStatusRunningEvent,
+    BetaManagedAgentsSessionThreadStatusTerminatedEvent,
     BetaManagedAgentsSpanModelRequestEndEvent,
     BetaManagedAgentsSpanModelRequestStartEvent,
     BetaManagedAgentsSpanModelUsage,
+    BetaManagedAgentsSpanOutcomeEvaluationEndEvent,
+    BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
+    BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
     BetaManagedAgentsStreamSessionEvents,
     BetaManagedAgentsTextBlock,
+    BetaManagedAgentsTextRubric,
+    BetaManagedAgentsTextRubricParams,
     BetaManagedAgentsUnknownError,
     BetaManagedAgentsURLDocumentSource,
     BetaManagedAgentsURLImageSource,
     BetaManagedAgentsUserCustomToolResultEvent,
     BetaManagedAgentsUserCustomToolResultEventParams,
+    BetaManagedAgentsUserDefineOutcomeEvent,
+    BetaManagedAgentsUserDefineOutcomeEventParams,
     BetaManagedAgentsUserInterruptEvent,
     BetaManagedAgentsUserInterruptEventParams,
     BetaManagedAgentsUserMessageEvent,
@@ -736,6 +761,34 @@ Methods:
 - <code title="delete /v1/sessions/{session_id}/resources/{resource_id}?beta=true">client.beta.sessions.resources.<a href="./src/anthropic/resources/beta/sessions/resources.py">delete</a>(resource_id, \*, session_id) -> <a href="./src/anthropic/types/beta/sessions/beta_managed_agents_delete_session_resource.py">BetaManagedAgentsDeleteSessionResource</a></code>
 - <code title="post /v1/sessions/{session_id}/resources?beta=true">client.beta.sessions.resources.<a href="./src/anthropic/resources/beta/sessions/resources.py">add</a>(session_id, \*\*<a href="src/anthropic/types/beta/sessions/resource_add_params.py">params</a>) -> <a href="./src/anthropic/types/beta/sessions/beta_managed_agents_file_resource.py">BetaManagedAgentsFileResource</a></code>
 
+### Threads
+
+Types:
+
+```python
+from anthropic.types.beta.sessions import (
+    BetaManagedAgentsSessionThread,
+    BetaManagedAgentsSessionThreadAgent,
+    BetaManagedAgentsSessionThreadStats,
+    BetaManagedAgentsSessionThreadStatus,
+    BetaManagedAgentsSessionThreadUsage,
+    BetaManagedAgentsStreamSessionThreadEvents,
+)
+```
+
+Methods:
+
+- <code title="get /v1/sessions/{session_id}/threads/{thread_id}?beta=true">client.beta.sessions.threads.<a href="./src/anthropic/resources/beta/sessions/threads/threads.py">retrieve</a>(thread_id, \*, session_id) -> <a href="./src/anthropic/types/beta/sessions/beta_managed_agents_session_thread.py">BetaManagedAgentsSessionThread</a></code>
+- <code title="get /v1/sessions/{session_id}/threads?beta=true">client.beta.sessions.threads.<a href="./src/anthropic/resources/beta/sessions/threads/threads.py">list</a>(session_id, \*\*<a href="src/anthropic/types/beta/sessions/thread_list_params.py">params</a>) -> <a href="./src/anthropic/types/beta/sessions/beta_managed_agents_session_thread.py">SyncPageCursor[BetaManagedAgentsSessionThread]</a></code>
+- <code title="post /v1/sessions/{session_id}/threads/{thread_id}/archive?beta=true">client.beta.sessions.threads.<a href="./src/anthropic/resources/beta/sessions/threads/threads.py">archive</a>(thread_id, \*, session_id) -> <a href="./src/anthropic/types/beta/sessions/beta_managed_agents_session_thread.py">BetaManagedAgentsSessionThread</a></code>
+
+#### Events
+
+Methods:
+
+- <code title="get /v1/sessions/{session_id}/threads/{thread_id}/events?beta=true">client.beta.sessions.threads.events.<a href="./src/anthropic/resources/beta/sessions/threads/events.py">list</a>(thread_id, \*, session_id, \*\*<a href="src/anthropic/types/beta/sessions/threads/event_list_params.py">params</a>) -> <a href="./src/anthropic/types/beta/sessions/beta_managed_agents_session_event.py">SyncPageCursor[BetaManagedAgentsSessionEvent]</a></code>
+- <code title="get /v1/sessions/{session_id}/threads/{thread_id}/stream?beta=true">client.beta.sessions.threads.events.<a href="./src/anthropic/resources/beta/sessions/threads/events.py">stream</a>(thread_id, \*, session_id) -> <a href="./src/anthropic/types/beta/sessions/beta_managed_agents_stream_session_thread_events.py">BetaManagedAgentsStreamSessionThreadEvents</a></code>
+
 ## Vaults
 
 Types:
@@ -760,13 +813,18 @@ Types:
 ```python
 from anthropic.types.beta.vaults import (
     BetaManagedAgentsCredential,
+    BetaManagedAgentsCredentialValidation,
+    BetaManagedAgentsCredentialValidationStatus,
     BetaManagedAgentsDeletedCredential,
     BetaManagedAgentsMCPOAuthAuthResponse,
     BetaManagedAgentsMCPOAuthCreateParams,
     BetaManagedAgentsMCPOAuthRefreshParams,
     BetaManagedAgentsMCPOAuthRefreshResponse,
     BetaManagedAgentsMCPOAuthRefreshUpdateParams,
     BetaManagedAgentsMCPOAuthUpdateParams,
+    BetaManagedAgentsMCPProbe,
+    BetaManagedAgentsRefreshHTTPResponse,
+    BetaManagedAgentsRefreshObject,
     BetaManagedAgentsStaticBearerAuthResponse,
     BetaManagedAgentsStaticBearerCreateParams,
     BetaManagedAgentsStaticBearerUpdateParams,
@@ -789,6 +847,7 @@ Methods:
 - <code title="get /v1/vaults/{vault_id}/credentials?beta=true">client.beta.vaults.credentials.<a href="./src/anthropic/resources/beta/vaults/credentials.py">list</a>(vault_id, \*\*<a href="src/anthropic/types/beta/vaults/credential_list_params.py">params</a>) -> <a href="./src/anthropic/types/beta/vaults/beta_managed_agents_credential.py">SyncPageCursor[BetaManagedAgentsCredential]</a></code>
 - <code title="delete /v1/vaults/{vault_id}/credentials/{credential_id}?beta=true">client.beta.vaults.credentials.<a href="./src/anthropic/resources/beta/vaults/credentials.py">delete</a>(credential_id, \*, vault_id) -> <a href="./src/anthropic/types/beta/vaults/beta_managed_agents_deleted_credential.py">BetaManagedAgentsDeletedCredential</a></code>
 - <code title="post /v1/vaults/{vault_id}/credentials/{credential_id}/archive?beta=true">client.beta.vaults.credentials.<a href="./src/anthropic/resources/beta/vaults/credentials.py">archive</a>(credential_id, \*, vault_id) -> <a href="./src/anthropic/types/beta/vaults/beta_managed_agents_credential.py">BetaManagedAgentsCredential</a></code>
+- <code title="post /v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate?beta=true">client.beta.vaults.credentials.<a href="./src/anthropic/resources/beta/vaults/credentials.py">mcp_oauth_validate</a>(credential_id, \*, vault_id) -> <a href="./src/anthropic/types/beta/vaults/beta_managed_agents_credential_validation.py">BetaManagedAgentsCredentialValidation</a></code>
 
 ## MemoryStores
 
@@ -912,6 +971,40 @@ Methods:
 - <code title="get /v1/skills/{skill_id}/versions?beta=true">client.beta.skills.versions.<a href="./src/anthropic/resources/beta/skills/versions.py">list</a>(skill_id, \*\*<a href="src/anthropic/types/beta/skills/version_list_params.py">params</a>) -> <a href="./src/anthropic/types/beta/skills/version_list_response.py">SyncPageCursor[VersionListResponse]</a></code>
 - <code title="delete /v1/skills/{skill_id}/versions/{version}?beta=true">client.beta.skills.versions.<a href="./src/anthropic/resources/beta/skills/versions.py">delete</a>(version, \*, skill_id) -> <a href="./src/anthropic/types/beta/skills/version_delete_response.py">VersionDeleteResponse</a></code>
 
+## Webhooks
+
+Types:
+
+```python
+from anthropic.types.beta import (
+    BetaWebhookEvent,
+    BetaWebhookEventData,
+    BetaWebhookSessionArchivedEventData,
+    BetaWebhookSessionCreatedEventData,
+    BetaWebhookSessionDeletedEventData,
+    BetaWebhookSessionIdledEventData,
+    BetaWebhookSessionOutcomeEvaluationEndedEventData,
+    BetaWebhookSessionPendingEventData,
+    BetaWebhookSessionRequiresActionEventData,
+    BetaWebhookSessionRunningEventData,
+    BetaWebhookSessionStatusIdledEventData,
+    BetaWebhookSessionStatusRunStartedEventData,
+    BetaWebhookSessionStatusScheduledEventData,
+    BetaWebhookSessionStatusTerminatedEventData,
+    BetaWebhookSessionThreadCreatedEventData,
+    BetaWebhookSessionThreadIdledEventData,
+    BetaWebhookSessionThreadTerminatedEventData,
+    BetaWebhookVaultArchivedEventData,
+    BetaWebhookVaultCreatedEventData,
+    BetaWebhookVaultCredentialArchivedEventData,
+    BetaWebhookVaultCredentialCreatedEventData,
+    BetaWebhookVaultCredentialDeletedEventData,
+    BetaWebhookVaultCredentialRefreshFailedEventData,
+    BetaWebhookVaultDeletedEventData,
+    UnwrapWebhookEvent,
+)
+```
+
 ## UserProfiles
 
 Types:

pyproject.toml

@@ -44,11 +44,13 @@ vertex = ["google-auth[requests] >=2, <3"]
 aws = ["boto3 >= 1.28.57", "botocore >= 1.31.57"]
 bedrock = ["boto3 >= 1.28.57", "botocore >= 1.31.57"]
 mcp = ["mcp>=1.0; python_version >= '3.10'"]
+webhooks = ["standardwebhooks >= 1.0.1, < 2"]
 
 [project.urls]
 Homepage = "https://github.com/anthropics/anthropic-sdk-python"
 Repository = "https://github.com/anthropics/anthropic-sdk-python"
 
+
 [tool.uv]
 managed = true
 required-version = ">=0.9"

requirements-dev.lock

@@ -11,16 +11,17 @@ asttokens==3.0.1
     # via inline-snapshot
 backports-asyncio-runner==1.2.0 ; python_full_version < '3.11'
     # via pytest-asyncio
-boto3-stubs==1.42.44
+boto3-stubs==1.42.69
 botocore-stubs==1.42.41
     # via boto3-stubs
-certifi==2026.1.4
+certifi==2026.2.25
     # via
     #   httpcore
     #   httpx
 colorama==0.4.6
     # via
     #   griffe
+    #   griffecli
     #   pytest
 dirty-equals==0.11
 distro==1.9.0
@@ -36,14 +37,22 @@ execnet==2.1.2
 executing==2.2.1
     # via inline-snapshot
 griffe==1.14.0 ; python_full_version < '3.10'
-griffe==1.15.0 ; python_full_version >= '3.10'
+griffe==2.0.0 ; python_full_version >= '3.10'
+griffecli==2.0.0 ; python_full_version >= '3.10'
+    # via griffe
+griffelib==2.0.0 ; python_full_version >= '3.10'
+    # via
+    #   griffe
+    #   griffecli
 h11==0.16.0
     # via httpcore
+http-snapshot==0.1.8
 httpcore==1.0.9
     # via httpx
 httpx==0.28.1
     # via
     #   anthropic
+    #   http-snapshot
     #   respx
 idna==3.11
     # via
@@ -54,7 +63,8 @@ iniconfig==2.1.0 ; python_full_version < '3.10'
     # via pytest
 iniconfig==2.3.0 ; python_full_version >= '3.10'
     # via pytest
-inline-snapshot==0.31.1
+inline-snapshot==0.32.5
+    # via http-snapshot
 jiter==0.13.0
     # via anthropic
 markdown-it-py==3.0.0 ; python_full_version < '3.10'
@@ -68,9 +78,9 @@ mypy-extensions==1.1.0
     # via mypy
 nodeenv==1.10.0
     # via pyright
-packaging==25.0
+packaging==26.0
     # via pytest
-pathspec==1.0.3
+pathspec==1.0.4
     # via mypy
 pluggy==1.6.0
     # via pytest
@@ -99,9 +109,9 @@ pytest-xdist==3.8.0
 python-dateutil==2.9.0.post0 ; python_full_version < '3.10'
     # via time-machine
 respx==0.22.0
-rich==14.2.0
+rich==14.3.3
     # via inline-snapshot
-ruff==0.14.13
+ruff==0.15.6
 six==1.17.0 ; python_full_version < '3.10'
     # via python-dateutil
 sniffio==1.3.1
@@ -113,7 +123,7 @@ tomli==2.4.0 ; python_full_version < '3.11'
     #   inline-snapshot
     #   mypy
     #   pytest
-types-awscrt==0.31.1
+types-awscrt==0.31.3
     # via botocore-stubs
 types-s3transfer==0.16.0
     # via boto3-stubs
@@ -123,6 +133,7 @@ typing-extensions==4.15.0
     #   anyio
     #   boto3-stubs
     #   exceptiongroup
+    #   inline-snapshot
     #   mypy
     #   pydantic
     #   pydantic-core

scripts/mock

@@ -24,7 +24,7 @@ if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
   npm exec --package=@stdy/cli@0.22.1 -- steady --version
 
-  npm exec --package=@stdy/cli@0.22.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=comma --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.22.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.22.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=comma --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.22.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi

scripts/test

@@ -43,7 +43,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.22.1 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=comma --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.22.1 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1

src/anthropic/__init__.py

@@ -40,6 +40,7 @@
     InternalServerError,
     PermissionDeniedError,
     UnprocessableEntityError,
+    APIWebhookValidationError,
     APIResponseValidationError,
 )
 from ._base_client import DefaultHttpxClient, DefaultAioHttpClient, DefaultAsyncHttpxClient
@@ -64,6 +65,7 @@
     "APITimeoutError",
     "APIConnectionError",
     "APIResponseValidationError",
+    "APIWebhookValidationError",
     "BadRequestError",
     "AuthenticationError",
     "PermissionDeniedError",

src/anthropic/_base_client.py

@@ -915,6 +915,7 @@ def __del__(self) -> None:
 class SyncAPIClient(BaseClient[httpx.Client, Stream[Any]]):
     _client: httpx.Client
     _default_stream_cls: type[Stream[Any]] | None = None
+    webhook_key: str | None = None
 
     def __init__(
         self,
@@ -1557,6 +1558,7 @@ def __del__(self) -> None:
 class AsyncAPIClient(BaseClient[httpx.AsyncClient, AsyncStream[Any]]):
     _client: httpx.AsyncClient
     _default_stream_cls: type[AsyncStream[Any]] | None = None
+    webhook_key: str | None = None
 
     def __init__(
         self,