anthropic 1.80.0 → 1.82.0

data/lib/anthropic/models/beta/vault_list_params.rb

@@ -9,7 +9,7 @@ module Anthropic
         include Anthropic::Internal::Type::RequestParameters
 
         # @!attribute include_archived
-        #   Whether to include archived vaults in the results.
+        #   Whether to include archived vaults in the results. Defaults to `false`.
         #
         #   @return [Boolean, nil]
         optional :include_archived, Anthropic::Internal::Type::Boolean
@@ -21,7 +21,9 @@ module Anthropic
         optional :limit, Integer
 
         # @!attribute page
-        #   Opaque pagination token from a previous `list_vaults` response.
+        #   The `next_page` value from a previous
+        #   [List Vaults](https://platform.claude.com/docs/en/api/beta/vaults/list)
+        #   response, to get the next page. Leave it out to get the first page.
         #
         #   @return [String, nil]
         optional :page, String
@@ -48,11 +50,11 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::VaultListParams} for more details.
         #
-        #   @param include_archived [Boolean] Whether to include archived vaults in the results.
+        #   @param include_archived [Boolean] Whether to include archived vaults in the results. Defaults to `false`.
         #
         #   @param limit [Integer] Maximum number of vaults to return per page. Defaults to 20, maximum 100.
         #
-        #   @param page [String] Opaque pagination token from a previous `list_vaults` response.
+        #   @param page [String] The `next_page` value from a previous [List Vaults](https://platform.claude.com/
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this
         #

data/lib/anthropic/models/beta/vaults/beta_managed_agents_credential.rb

@@ -7,7 +7,7 @@ module Anthropic
         # @see Anthropic::Resources::Beta::Vaults::Credentials#create
         class BetaManagedAgentsCredential < Anthropic::Internal::Type::BaseModel
           # @!attribute id
-          #   Unique identifier for the credential.
+          #   The unique ID of the credential (`vcrd_...`).
           #
           #   @return [String]
           required :id, String
@@ -63,7 +63,7 @@ module Anthropic
           #   A credential stored in a vault. Sensitive fields are never returned in
           #   responses.
           #
-          #   @param id [String] Unique identifier for the credential.
+          #   @param id [String] The unique ID of the credential (`vcrd_...`).
           #
           #   @param archived_at [Time, nil] When the credential was archived. Null if not archived.
           #
@@ -116,13 +116,17 @@ module Anthropic
             # Creates a new instance of the variant class whose `type` matches the given
             # value, passing the remaining arguments to its constructor.
             #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Vaults::BetaManagedAgentsCredential::Auth} for more
+            # details.
+            #
             # @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsCredential::Auth::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #
             #   @option args [String] :mcp_server_url URL of the MCP server this credential authenticates against.
             #
-            #   @option args [Time, nil] :expires_at A timestamp in RFC 3339 format
+            #   @option args [Time, nil] :expires_at When the credential's access token expires, in RFC 3339. Absent if the expiry is
             #
             #   @option args [Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshResponse, nil] :refresh Refresh token configuration, if the credential supports token refresh.
             #

data/lib/anthropic/models/beta/vaults/beta_managed_agents_credential_networking_params.rb

@@ -40,7 +40,7 @@ module Anthropic
           #
           # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
           #
-          #   @option args [Array<String>] :allowed_hosts Hostnames on which the secret will be substituted. Each entry is a bare hostname
+          #   @option args [Array<String>] :allowed_hosts The destination hosts of the outbound requests that the credential's secret is s
           #
           # @raise [ArgumentError]
           # @return [Anthropic::Models::Beta::Vaults::BetaManagedAgentsUnrestrictedCredentialNetworkingParams, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingParams]

data/lib/anthropic/models/beta/vaults/beta_managed_agents_credential_validation.rb

@@ -19,7 +19,8 @@ module Anthropic
           required :has_refresh_token, Anthropic::Internal::Type::Boolean
 
           # @!attribute mcp_probe
-          #   Details of the failing MCP probe step. Null when the probe succeeded.
+          #   Details of the MCP probe step that failed, or `null` if the probe succeeded or
+          #   there was no access token to test.
           #
           #   @return [Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPProbe, nil]
           required :mcp_probe, -> { Anthropic::Beta::Vaults::BetaManagedAgentsMCPProbe }, nil?: true
@@ -65,7 +66,7 @@ module Anthropic
           #
           #   @param has_refresh_token [Boolean] Whether the credential has a refresh token configured.
           #
-          #   @param mcp_probe [Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPProbe, nil] Details of the failing MCP probe step. Null when the probe succeeded.
+          #   @param mcp_probe [Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPProbe, nil] Details of the MCP probe step that failed, or `null` if the probe succeeded or t
           #
           #   @param refresh [Anthropic::Models::Beta::Vaults::BetaManagedAgentsRefreshObject, nil] Details of the refresh-token exchange attempted on a 401. Null when no refresh w
           #

data/lib/anthropic/models/beta/vaults/beta_managed_agents_credential_validation_status.rb

@@ -11,10 +11,10 @@ module Anthropic
           # The credential successfully authenticated against its MCP server.
           VALID = :valid
 
-          # The probe reached the MCP server and was rejected, and a refresh (if attempted) did not recover it.
+          # The probe reached the MCP server and the server rejected the credential, or no access token is stored. A refresh, if one was tried, didn't recover it. Usually the end user needs to authorize again.
           INVALID = :invalid
 
-          # The probe could not determine validity — for example, a transport error or a successful refresh that was not re-probed.
+          # The probe couldn't tell whether the credential works, for example because of a network error or because a refresh succeeded but the new access token wasn't tested. Validate the credential again to find out.
           UNKNOWN = :unknown
 
           # @!method self.values

data/lib/anthropic/models/beta/vaults/beta_managed_agents_deleted_credential.rb

@@ -7,7 +7,7 @@ module Anthropic
         # @see Anthropic::Resources::Beta::Vaults::Credentials#delete
         class BetaManagedAgentsDeletedCredential < Anthropic::Internal::Type::BaseModel
           # @!attribute id
-          #   Unique identifier of the deleted credential.
+          #   The unique ID of the deleted credential (`vcrd_...`).
           #
           #   @return [String]
           required :id, String
@@ -20,7 +20,7 @@ module Anthropic
           # @!method initialize(id:, type:)
           #   Confirmation of a deleted credential.
           #
-          #   @param id [String] Unique identifier of the deleted credential.
+          #   @param id [String] The unique ID of the deleted credential (`vcrd_...`).
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsDeletedCredential::Type]
 

data/lib/anthropic/models/beta/vaults/beta_managed_agents_environment_variable_auth_response.rb

@@ -80,7 +80,7 @@ module Anthropic
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #
-            #   @option args [Array<String>] :allowed_hosts Hostnames on which the secret will be substituted. An entry matches the request
+            #   @option args [Array<String>] :allowed_hosts The destination hosts of the outbound requests that the credential's secret is s
             #
             # @raise [ArgumentError]
             # @return [Anthropic::Models::Beta::Vaults::BetaManagedAgentsUnrestrictedCredentialNetworkingResponse, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingResponse]

data/lib/anthropic/models/beta/vaults/beta_managed_agents_environment_variable_create_params.rb

@@ -18,7 +18,8 @@ module Anthropic
           required :secret_name, String
 
           # @!attribute secret_value
-          #   Secret value. Write-only; never returned in responses.
+          #   The secret to substitute into the agent's outbound requests. It's write-only and
+          #   never returned in responses.
           #
           #   @return [String]
           required :secret_value, String
@@ -38,11 +39,15 @@ module Anthropic
           # @!method initialize(networking:, secret_name:, secret_value:, type:, injection_location: nil)
           #   Parameters for creating an environment variable credential.
           #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsEnvironmentVariableCreateParams}
+          #   for more details.
+          #
           #   @param networking [Anthropic::Models::Beta::Vaults::BetaManagedAgentsUnrestrictedCredentialNetworkingParams, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingParams] Outbound hosts the secret value is substituted on.
           #
           #   @param secret_name [String] Name of the environment variable. Immutable after create.
           #
-          #   @param secret_value [String] Secret value. Write-only; never returned in responses.
+          #   @param secret_value [String] The secret to substitute into the agent's outbound requests. It's write-only and
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsEnvironmentVariableCreateParams::Type]
           #

data/lib/anthropic/models/beta/vaults/beta_managed_agents_environment_variable_update_params.rb

@@ -19,7 +19,7 @@ module Anthropic
                    -> { Anthropic::Beta::Vaults::BetaManagedAgentsInjectionLocationUpdateParams }
 
           # @!attribute networking
-          #   Updated networking scope. Full replacement.
+          #   The new networking scope, which replaces the stored one as a whole.
           #
           #   @return [Anthropic::Models::Beta::Vaults::BetaManagedAgentsUnrestrictedCredentialNetworkingParams, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingParams, nil]
           optional :networking,
@@ -27,7 +27,7 @@ module Anthropic
                    nil?: true
 
           # @!attribute secret_value
-          #   Updated secret value.
+          #   The new secret value to replace the stored one.
           #
           #   @return [String, nil]
           optional :secret_value, String, nil?: true
@@ -40,9 +40,9 @@ module Anthropic
           #
           #   @param injection_location [Anthropic::Models::Beta::Vaults::BetaManagedAgentsInjectionLocationUpdateParams] Updated injection location.
           #
-          #   @param networking [Anthropic::Models::Beta::Vaults::BetaManagedAgentsUnrestrictedCredentialNetworkingParams, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingParams, nil] Updated networking scope. Full replacement.
+          #   @param networking [Anthropic::Models::Beta::Vaults::BetaManagedAgentsUnrestrictedCredentialNetworkingParams, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingParams, nil] The new networking scope, which replaces the stored one as a whole.
           #
-          #   @param secret_value [String, nil] Updated secret value.
+          #   @param secret_value [String, nil] The new secret value to replace the stored one.
 
           # @see Anthropic::Models::Beta::Vaults::BetaManagedAgentsEnvironmentVariableUpdateParams#type
           module Type

data/lib/anthropic/models/beta/vaults/beta_managed_agents_injection_location_update_params.rb

@@ -18,7 +18,14 @@ module Anthropic
           optional :header, Anthropic::Internal::Type::Boolean
 
           # @!method initialize(body: nil, header: nil)
-          #   Updated injection location.
+          #   Changes which parts of an outbound request the secret is substituted into. A
+          #   location you leave out keeps its current setting.
+          #
+          #   After the change, at least one location must be enabled.
+          #
+          #   See
+          #   [Authenticate with vaults](https://platform.claude.com/docs/en/managed-agents/vaults#add-a-credential)
+          #   to learn more about injection locations.
           #
           #   @param body [Boolean] Substitute when the placeholder appears in the request body.
           #

data/lib/anthropic/models/beta/vaults/beta_managed_agents_limited_credential_networking_params.rb

@@ -6,10 +6,12 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsLimitedCredentialNetworkingParams < Anthropic::Internal::Type::BaseModel
           # @!attribute allowed_hosts
-          #   Hostnames on which the secret will be substituted. Each entry is a bare hostname
-          #   (`api.example.com`), an IPv4 address (`192.0.2.1`), or a `*.`-prefixed wildcard
-          #   (`*.example.com`). URLs, ports, paths, and IPv6 addresses are not accepted. At
-          #   most 16 entries.
+          #   The destination hosts of the outbound requests that the credential's secret is
+          #   substituted into.
+          #
+          #   Each entry is a bare hostname (`api.example.com`), an IPv4 address
+          #   (`192.0.2.1`), or a `*.` wildcard (`*.example.com`). URLs, ports, paths, and
+          #   IPv6 addresses aren't accepted. The list can have up to 16 entries.
           #
           #   @return [Array<String>]
           required :allowed_hosts, Anthropic::Internal::Type::ArrayOf[String]
@@ -27,7 +29,7 @@ module Anthropic
           #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingParams}
           #   for more details.
           #
-          #   @param allowed_hosts [Array<String>] Hostnames on which the secret will be substituted. Each entry is a bare hostname
+          #   @param allowed_hosts [Array<String>] The destination hosts of the outbound requests that the credential's secret is s
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingParams::Type]
 

data/lib/anthropic/models/beta/vaults/beta_managed_agents_limited_credential_networking_response.rb

@@ -6,9 +6,11 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsLimitedCredentialNetworkingResponse < Anthropic::Internal::Type::BaseModel
           # @!attribute allowed_hosts
-          #   Hostnames on which the secret will be substituted. An entry matches the request
-          #   host exactly; a `*.`-prefixed entry matches any subdomain of the named domain
-          #   but not the domain itself.
+          #   The destination hosts of the outbound requests that the credential's secret is
+          #   substituted into.
+          #
+          #   An entry matches the request host exactly. An entry such as `*.example.com`
+          #   matches any subdomain of `example.com` but not `example.com` itself.
           #
           #   @return [Array<String>]
           required :allowed_hosts, Anthropic::Internal::Type::ArrayOf[String]
@@ -26,7 +28,7 @@ module Anthropic
           #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingResponse}
           #   for more details.
           #
-          #   @param allowed_hosts [Array<String>] Hostnames on which the secret will be substituted. An entry matches the request
+          #   @param allowed_hosts [Array<String>] The destination hosts of the outbound requests that the credential's secret is s
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsLimitedCredentialNetworkingResponse::Type]
 

data/lib/anthropic/models/beta/vaults/beta_managed_agents_mcp_oauth_auth_response.rb

@@ -17,7 +17,8 @@ module Anthropic
           required :type, enum: -> { Anthropic::Beta::Vaults::BetaManagedAgentsMCPOAuthAuthResponse::Type }
 
           # @!attribute expires_at
-          #   A timestamp in RFC 3339 format
+          #   When the credential's access token expires, in RFC 3339. Absent if the expiry
+          #   isn't known.
           #
           #   @return [Time, nil]
           optional :expires_at, Time, nil?: true
@@ -35,11 +36,15 @@ module Anthropic
           # @!method initialize(mcp_server_url:, type:, expires_at: nil, refresh: nil)
           #   OAuth credential details for an MCP server.
           #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthAuthResponse} for
+          #   more details.
+          #
           #   @param mcp_server_url [String] URL of the MCP server this credential authenticates against.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthAuthResponse::Type]
           #
-          #   @param expires_at [Time, nil] A timestamp in RFC 3339 format
+          #   @param expires_at [Time, nil] When the credential's access token expires, in RFC 3339. Absent if the expiry is
           #
           #   @param refresh [Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshResponse, nil] Refresh token configuration, if the credential supports token refresh.
 

data/lib/anthropic/models/beta/vaults/beta_managed_agents_mcp_oauth_create_params.rb

@@ -6,7 +6,7 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsMCPOAuthCreateParams < Anthropic::Internal::Type::BaseModel
           # @!attribute access_token
-          #   OAuth access token.
+          #   The OAuth access token to send to the MCP server.
           #
           #   @return [String]
           required :access_token, String
@@ -23,7 +23,9 @@ module Anthropic
           required :type, enum: -> { Anthropic::Beta::Vaults::BetaManagedAgentsMCPOAuthCreateParams::Type }
 
           # @!attribute expires_at
-          #   A timestamp in RFC 3339 format
+          #   When `access_token` expires, in RFC 3339.
+          #
+          #   Must be in the future.
           #
           #   @return [Time, nil]
           optional :expires_at, Time, nil?: true
@@ -41,13 +43,17 @@ module Anthropic
           # @!method initialize(access_token:, mcp_server_url:, type:, expires_at: nil, refresh: nil)
           #   Parameters for creating an MCP OAuth credential.
           #
-          #   @param access_token [String] OAuth access token.
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthCreateParams} for
+          #   more details.
+          #
+          #   @param access_token [String] The OAuth access token to send to the MCP server.
           #
           #   @param mcp_server_url [String] URL of the MCP server this credential authenticates against.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthCreateParams::Type]
           #
-          #   @param expires_at [Time, nil] A timestamp in RFC 3339 format
+          #   @param expires_at [Time, nil] When `access_token` expires, in RFC 3339.
           #
           #   @param refresh [Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshParams, nil] Refresh token configuration, if the credential supports token refresh.
 

data/lib/anthropic/models/beta/vaults/beta_managed_agents_mcp_oauth_refresh_params.rb

@@ -6,13 +6,15 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsMCPOAuthRefreshParams < Anthropic::Internal::Type::BaseModel
           # @!attribute client_id
-          #   OAuth client ID.
+          #   The OAuth client ID to use when refreshing the access token. It can't be changed
+          #   after the credential is created.
           #
           #   @return [String]
           required :client_id, String
 
           # @!attribute refresh_token
-          #   OAuth refresh token.
+          #   The OAuth refresh token that the API uses to get a new access token when the
+          #   current one expires.
           #
           #   @return [String]
           required :refresh_token, String
@@ -44,9 +46,13 @@ module Anthropic
           # @!method initialize(client_id:, refresh_token:, token_endpoint:, token_endpoint_auth:, resource: nil, scope: nil)
           #   OAuth refresh token parameters for creating a credential with refresh support.
           #
-          #   @param client_id [String] OAuth client ID.
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshParams} for
+          #   more details.
           #
-          #   @param refresh_token [String] OAuth refresh token.
+          #   @param client_id [String] The OAuth client ID to use when refreshing the access token. It can't be changed
+          #
+          #   @param refresh_token [String] The OAuth refresh token that the API uses to get a new access token when the cur
           #
           #   @param token_endpoint [String] Token endpoint URL used to refresh the access token.
           #
@@ -88,11 +94,15 @@ module Anthropic
             # Creates a new instance of the variant class whose `type` matches the given
             # value, passing the remaining arguments to its constructor.
             #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshParams::TokenEndpointAuth}
+            # for more details.
+            #
             # @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshParams::TokenEndpointAuth::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #
-            #   @option args [String] :client_secret OAuth client secret.
+            #   @option args [String] :client_secret The OAuth client secret, sent to `token_endpoint` with HTTP Basic authentication
             #
             # @raise [ArgumentError]
             # @return [Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthNoneParam, Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicParam, Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthPostParam]

data/lib/anthropic/models/beta/vaults/beta_managed_agents_mcp_oauth_refresh_response.rb

@@ -6,7 +6,7 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsMCPOAuthRefreshResponse < Anthropic::Internal::Type::BaseModel
           # @!attribute client_id
-          #   OAuth client ID.
+          #   The OAuth client ID used when refreshing the access token.
           #
           #   @return [String]
           required :client_id, String
@@ -38,7 +38,7 @@ module Anthropic
           # @!method initialize(client_id:, token_endpoint:, token_endpoint_auth:, resource: nil, scope: nil)
           #   OAuth refresh token configuration returned in credential responses.
           #
-          #   @param client_id [String] OAuth client ID.
+          #   @param client_id [String] The OAuth client ID used when refreshing the access token.
           #
           #   @param token_endpoint [String] Token endpoint URL used to refresh the access token.
           #

data/lib/anthropic/models/beta/vaults/beta_managed_agents_mcp_oauth_refresh_update_params.rb

@@ -6,13 +6,14 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsMCPOAuthRefreshUpdateParams < Anthropic::Internal::Type::BaseModel
           # @!attribute refresh_token
-          #   Updated OAuth refresh token.
+          #   The new OAuth refresh token to replace the stored one.
           #
           #   @return [String, nil]
           optional :refresh_token, String, nil?: true
 
           # @!attribute scope
-          #   Updated OAuth scope for the refresh request.
+          #   The new OAuth scope for refresh requests. Send an empty string to clear the
+          #   stored scope.
           #
           #   @return [String, nil]
           optional :scope, String, nil?: true
@@ -26,9 +27,13 @@ module Anthropic
           # @!method initialize(refresh_token: nil, scope: nil, token_endpoint_auth: nil)
           #   Parameters for updating OAuth refresh token configuration.
           #
-          #   @param refresh_token [String, nil] Updated OAuth refresh token.
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshUpdateParams}
+          #   for more details.
           #
-          #   @param scope [String, nil] Updated OAuth scope for the refresh request.
+          #   @param refresh_token [String, nil] The new OAuth refresh token to replace the stored one.
+          #
+          #   @param scope [String, nil] The new OAuth scope for refresh requests. Send an empty string to clear the stor
           #
           #   @param token_endpoint_auth [Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicUpdateParam, Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthPostUpdateParam]
 
@@ -62,11 +67,15 @@ module Anthropic
             # Creates a new instance of the variant class whose `type` matches the given
             # value, passing the remaining arguments to its constructor.
             #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshUpdateParams::TokenEndpointAuth}
+            # for more details.
+            #
             # @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshUpdateParams::TokenEndpointAuth::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #
-            #   @option args [String, nil] :client_secret Updated OAuth client secret.
+            #   @option args [String, nil] :client_secret A new OAuth client secret to replace the stored one.
             #
             # @raise [ArgumentError]
             # @return [Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicUpdateParam, Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthPostUpdateParam]

data/lib/anthropic/models/beta/vaults/beta_managed_agents_mcp_oauth_update_params.rb

@@ -11,13 +11,19 @@ module Anthropic
           required :type, enum: -> { Anthropic::Beta::Vaults::BetaManagedAgentsMCPOAuthUpdateParams::Type }
 
           # @!attribute access_token
-          #   Updated OAuth access token.
+          #   The new OAuth access token to replace the stored one.
           #
           #   @return [String, nil]
           optional :access_token, String, nil?: true
 
           # @!attribute expires_at
-          #   A timestamp in RFC 3339 format
+          #   When the credential's access token expires, in RFC 3339. Leave it out to keep
+          #   the stored expiry.
+          #
+          #   If you send a new `access_token`, send its `expires_at` too, or the new token
+          #   keeps the old expiry.
+          #
+          #   Must be in the future.
           #
           #   @return [Time, nil]
           optional :expires_at, Time, nil?: true
@@ -34,11 +40,15 @@ module Anthropic
           #   Parameters for updating an MCP OAuth credential. The `mcp_server_url` is
           #   immutable.
           #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthUpdateParams} for
+          #   more details.
+          #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthUpdateParams::Type]
           #
-          #   @param access_token [String, nil] Updated OAuth access token.
+          #   @param access_token [String, nil] The new OAuth access token to replace the stored one.
           #
-          #   @param expires_at [Time, nil] A timestamp in RFC 3339 format
+          #   @param expires_at [Time, nil] When the credential's access token expires, in RFC 3339. Leave it out to keep th
           #
           #   @param refresh [Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPOAuthRefreshUpdateParams, nil] Updated refresh token configuration.
 

data/lib/anthropic/models/beta/vaults/beta_managed_agents_mcp_probe.rb

@@ -6,8 +6,9 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsMCPProbe < Anthropic::Internal::Type::BaseModel
           # @!attribute http_response
-          #   The captured HTTP error response. Null when no HTTP response was received
-          #   (timeout, DNS, TLS).
+          #   The HTTP error response from the MCP server, or `null` if the MCP server didn't
+          #   return one for the failing step, for example after a timeout or a DNS or TLS
+          #   failure.
           #
           #   @return [Anthropic::Models::Beta::Vaults::BetaManagedAgentsRefreshHTTPResponse, nil]
           required :http_response,
@@ -28,7 +29,7 @@ module Anthropic
           #   Some parameter documentations has been truncated, see
           #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsMCPProbe} for more details.
           #
-          #   @param http_response [Anthropic::Models::Beta::Vaults::BetaManagedAgentsRefreshHTTPResponse, nil] The captured HTTP error response. Null when no HTTP response was received (timeo
+          #   @param http_response [Anthropic::Models::Beta::Vaults::BetaManagedAgentsRefreshHTTPResponse, nil] The HTTP error response from the MCP server, or `null` if the MCP server didn't
           #
           #   @param method_ [String] The MCP method that failed (for example `initialize` or `tools/list`).
         end

data/lib/anthropic/models/beta/vaults/beta_managed_agents_static_bearer_create_params.rb

@@ -6,7 +6,8 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsStaticBearerCreateParams < Anthropic::Internal::Type::BaseModel
           # @!attribute token
-          #   Static bearer token value.
+          #   The static bearer token to send to the MCP server, such as an API key or
+          #   personal access token.
           #
           #   @return [String]
           required :token, String
@@ -25,7 +26,11 @@ module Anthropic
           # @!method initialize(token:, mcp_server_url:, type:)
           #   Parameters for creating a static bearer token credential.
           #
-          #   @param token [String] Static bearer token value.
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsStaticBearerCreateParams} for
+          #   more details.
+          #
+          #   @param token [String] The static bearer token to send to the MCP server, such as an API key or persona
           #
           #   @param mcp_server_url [String] URL of the MCP server this credential authenticates against.
           #

data/lib/anthropic/models/beta/vaults/beta_managed_agents_static_bearer_update_params.rb

@@ -11,7 +11,7 @@ module Anthropic
           required :type, enum: -> { Anthropic::Beta::Vaults::BetaManagedAgentsStaticBearerUpdateParams::Type }
 
           # @!attribute token
-          #   Updated static bearer token value.
+          #   The new static bearer token to replace the stored one.
           #
           #   @return [String, nil]
           optional :token, String, nil?: true
@@ -22,7 +22,7 @@ module Anthropic
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsStaticBearerUpdateParams::Type]
           #
-          #   @param token [String, nil] Updated static bearer token value.
+          #   @param token [String, nil] The new static bearer token to replace the stored one.
 
           # @see Anthropic::Models::Beta::Vaults::BetaManagedAgentsStaticBearerUpdateParams#type
           module Type

data/lib/anthropic/models/beta/vaults/beta_managed_agents_token_endpoint_auth_basic_param.rb

@@ -6,7 +6,8 @@ module Anthropic
       module Vaults
         class BetaManagedAgentsTokenEndpointAuthBasicParam < Anthropic::Internal::Type::BaseModel
           # @!attribute client_secret
-          #   OAuth client secret.
+          #   The OAuth client secret, sent to `token_endpoint` with HTTP Basic
+          #   authentication.
           #
           #   @return [String]
           required :client_secret, String
@@ -19,7 +20,11 @@ module Anthropic
           # @!method initialize(client_secret:, type:)
           #   Token endpoint uses HTTP Basic authentication with client credentials.
           #
-          #   @param client_secret [String] OAuth client secret.
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicParam}
+          #   for more details.
+          #
+          #   @param client_secret [String] The OAuth client secret, sent to `token_endpoint` with HTTP Basic authentication
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicParam::Type]
 

data/lib/anthropic/models/beta/vaults/beta_managed_agents_token_endpoint_auth_basic_update_param.rb

@@ -12,7 +12,11 @@ module Anthropic
                    enum: -> { Anthropic::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicUpdateParam::Type }
 
           # @!attribute client_secret
-          #   Updated OAuth client secret.
+          #   A new OAuth client secret to replace the stored one.
+          #
+          #   The credential must already use `client_secret_basic` or `client_secret_post`.
+          #   It keeps its current `token_endpoint_auth` type, even if the `type` sent with
+          #   this secret is the other one.
           #
           #   @return [String, nil]
           optional :client_secret, String, nil?: true
@@ -20,9 +24,13 @@ module Anthropic
           # @!method initialize(type:, client_secret: nil)
           #   Updated HTTP Basic authentication parameters for the token endpoint.
           #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicUpdateParam}
+          #   for more details.
+          #
           #   @param type [Symbol, Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicUpdateParam::Type]
           #
-          #   @param client_secret [String, nil] Updated OAuth client secret.
+          #   @param client_secret [String, nil] A new OAuth client secret to replace the stored one.
 
           # @see Anthropic::Models::Beta::Vaults::BetaManagedAgentsTokenEndpointAuthBasicUpdateParam#type
           module Type