anthropic 1.80.0 → 1.81.0

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

@@ -8,16 +8,38 @@ module Anthropic
 
         discriminator :type
 
+        # A `cache_miss_reason` for a request whose `model` or `speed` differs from the previous request's.
+        #
+        # See the [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types) to learn what to change for each reason.
         variant :model_changed, -> { Anthropic::Beta::BetaCacheMissModelChanged }
 
+        # A `cache_miss_reason` for a request whose `system` differs from the previous request's.
+        #
+        # See the [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types) to learn what to change for each reason.
         variant :system_changed, -> { Anthropic::Beta::BetaCacheMissSystemChanged }
 
+        # A `cache_miss_reason` for a request whose `tools` differ from the previous request's, for example because tools were added, removed, or reordered.
+        #
+        # See the [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types) to learn what to change for each reason.
         variant :tools_changed, -> { Anthropic::Beta::BetaCacheMissToolsChanged }
 
+        # A `cache_miss_reason` for a request whose `messages` differ from the previous request's in an earlier entry, instead of only having entries appended. The `model`, `system`, and `tools` match.
+        #
+        # See the [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types) to learn what to change for each reason.
         variant :messages_changed, -> { Anthropic::Beta::BetaCacheMissMessagesChanged }
 
+        # A `cache_miss_reason` for when the API doesn't have a stored record of the request that `diagnostics.previous_message_id` references.
+        #
+        # This doesn't mean that this request changed.
+        #
+        # See the [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types) to learn what to change for each reason.
         variant :previous_message_not_found, -> { Anthropic::Beta::BetaCacheMissPreviousMessageNotFound }
 
+        # A `cache_miss_reason` for when the API can't give a diagnosis. The request itself was processed normally.
+        #
+        # This includes a request whose `model`, `system`, and `tools` match the previous request's but whose other prompt-affecting parameters, such as `thinking` or `tool_choice`, differ.
+        #
+        # See the [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types) to learn what to change for each reason.
         variant :unavailable, -> { Anthropic::Beta::BetaCacheMissUnavailable }
 
         module Type

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

@@ -17,6 +17,13 @@ module Anthropic
         required :type, const: :system_changed
 
         # @!method initialize(cache_missed_input_tokens:, type: :system_changed)
+        #   A `cache_miss_reason` for a request whose `system` differs from the previous
+        #   request's.
+        #
+        #   See the
+        #   [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types)
+        #   to learn what to change for each reason.
+        #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaCacheMissSystemChanged} for more details.
         #

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

@@ -17,6 +17,13 @@ module Anthropic
         required :type, const: :tools_changed
 
         # @!method initialize(cache_missed_input_tokens:, type: :tools_changed)
+        #   A `cache_miss_reason` for a request whose `tools` differ from the previous
+        #   request's, for example because tools were added, removed, or reordered.
+        #
+        #   See the
+        #   [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types)
+        #   to learn what to change for each reason.
+        #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaCacheMissToolsChanged} for more details.
         #

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

@@ -10,6 +10,17 @@ module Anthropic
         required :type, const: :unavailable
 
         # @!method initialize(type: :unavailable)
+        #   A `cache_miss_reason` for when the API can't give a diagnosis. The request
+        #   itself was processed normally.
+        #
+        #   This includes a request whose `model`, `system`, and `tools` match the previous
+        #   request's but whose other prompt-affecting parameters, such as `thinking` or
+        #   `tool_choice`, differ.
+        #
+        #   See the
+        #   [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types)
+        #   to learn what to change for each reason.
+        #
         #   @param type [Symbol, :unavailable]
       end
     end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # @see Anthropic::Resources::Beta::UserProfiles#delete
+      class BetaDeletedUserProfile < Anthropic::Internal::Type::BaseModel
+        # @!attribute id
+        #   Identifier of the deleted user profile, prefixed `uprof_`.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute type
+        #   Object type. Always `user_profile_deleted`.
+        #
+        #   @return [Symbol, :user_profile_deleted]
+        required :type, const: :user_profile_deleted
+
+        # @!method initialize(id:, type: :user_profile_deleted)
+        #   @param id [String] Identifier of the deleted user profile, prefixed `uprof_`.
+        #
+        #   @param type [Symbol, :user_profile_deleted] Object type. Always `user_profile_deleted`.
+      end
+    end
+
+    BetaDeletedUserProfile = Beta::BetaDeletedUserProfile
+  end
+end

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

@@ -14,24 +14,68 @@ module Anthropic
         required :model, union: -> { Anthropic::Model }
 
         # @!attribute max_tokens
+        #   The `max_tokens` for the fallback attempt that uses this `fallbacks` entry's
+        #   `model`, in place of the request's `max_tokens`. If you leave it out or set it
+        #   to `null`, the attempt uses the request's `max_tokens`.
+        #
+        #   See the
+        #   [refusals and fallback guide](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#naming-your-own-fallback-models)
+        #   to learn more about fallback entries.
         #
         #   @return [Integer, nil]
         optional :max_tokens, Integer, nil?: true
 
         # @!attribute output_config
+        #   Output parameters for the fallback attempt that uses this `fallbacks` entry's
+        #   `model`, combined with the request's `output_config` one field at a time.
+        #
+        #   - `format`: If you leave it out, the attempt uses the request's `format`. If you
+        #     set it to `null`, the attempt runs without a format.
+        #   - `effort`: If you leave it out, the attempt uses the request's `effort` when
+        #     `model` supports that level with the attempt's `thinking`. If the request
+        #     doesn't set `effort`, if `model` doesn't support the level, or if you set
+        #     `effort` to `null`, the attempt runs at the default effort of `model`.
+        #   - `task_budget`: If you leave it out, the attempt uses the request's
+        #     `task_budget` when `model` accepts a task budget of that size. If the request
+        #     doesn't set `task_budget`, if `model` doesn't accept it, or if you set
+        #     `task_budget` to `null`, the attempt runs without a task budget.
+        #
+        #   Set `output_config` to `null` to run the attempt without a format or a task
+        #   budget, at the default effort of `model`.
+        #
+        #   These rules apply with the `server-side-fallback-2026-07-01` beta header.
         #
         #   @return [Anthropic::Models::Beta::BetaOutputConfig, nil]
         optional :output_config, -> { Anthropic::Beta::BetaOutputConfig }, nil?: true
 
         # @!attribute speed
-        #   Inference speed mode. `fast` provides significantly faster output token
-        #   generation at premium pricing. Not all models support `fast`; invalid
-        #   combinations are rejected at create time.
+        #   The inference speed mode for the fallback attempt that uses this `fallbacks`
+        #   entry's `model`. If you leave it out, the attempt runs at `fast` speed only when
+        #   the request sets `speed` to `fast` and your organization can use fast mode on
+        #   `model`.
+        #
+        #   Otherwise, or when you set this field to `null`, the attempt runs at `standard`
+        #   speed.
+        #
+        #   These rules apply with the `server-side-fallback-2026-07-01` beta header.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaFallbackParam::Speed, nil]
         optional :speed, enum: -> { Anthropic::Beta::BetaFallbackParam::Speed }, nil?: true
 
         # @!attribute thinking
+        #   The thinking configuration for the fallback attempt that uses this `fallbacks`
+        #   entry's `model`. If you leave it out, the attempt uses the request's `thinking`
+        #   when `model` supports that thinking `type`.
+        #
+        #   If you leave it out and the request's thinking `type` is `between_tools` but
+        #   `model` doesn't support `between_tools`, the attempt uses `disabled` if `model`
+        #   supports it. Otherwise, if `model` doesn't support the request's thinking
+        #   `type`, if the request doesn't set `thinking`, or if you set this field to
+        #   `null`, the attempt uses the thinking `type` that `model` uses when a request
+        #   leaves out `thinking`. The request's `thinking.display` still applies where
+        #   `model` allows it.
+        #
+        #   These rules apply with the `server-side-fallback-2026-07-01` beta header.
         #
         #   @return [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
         optional :thinking, union: -> { Anthropic::Beta::BetaFallbackParam::Thinking }, nil?: true
@@ -49,17 +93,23 @@ module Anthropic
         #
         #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
         #
-        #   @param max_tokens [Integer, nil]
+        #   @param max_tokens [Integer, nil] The `max_tokens` for the fallback attempt that uses this `fallbacks` entry's `mo
         #
-        #   @param output_config [Anthropic::Models::Beta::BetaOutputConfig, nil]
+        #   @param output_config [Anthropic::Models::Beta::BetaOutputConfig, nil] Output parameters for the fallback attempt that uses this `fallbacks` entry's `m
         #
-        #   @param speed [Symbol, Anthropic::Models::Beta::BetaFallbackParam::Speed, nil] Inference speed mode. `fast` provides significantly faster output token generati
+        #   @param speed [Symbol, Anthropic::Models::Beta::BetaFallbackParam::Speed, nil] The inference speed mode for the fallback attempt that uses this `fallbacks` ent
         #
-        #   @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
+        #   @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil] The thinking configuration for the fallback attempt that uses this `fallbacks` e
 
-        # Inference speed mode. `fast` provides significantly faster output token
-        # generation at premium pricing. Not all models support `fast`; invalid
-        # combinations are rejected at create time.
+        # The inference speed mode for the fallback attempt that uses this `fallbacks`
+        # entry's `model`. If you leave it out, the attempt runs at `fast` speed only when
+        # the request sets `speed` to `fast` and your organization can use fast mode on
+        # `model`.
+        #
+        # Otherwise, or when you set this field to `null`, the attempt runs at `standard`
+        # speed.
+        #
+        # These rules apply with the `server-side-fallback-2026-07-01` beta header.
         #
         # @see Anthropic::Models::Beta::BetaFallbackParam#speed
         module Speed
@@ -72,6 +122,20 @@ module Anthropic
           #   @return [Array<Symbol>]
         end
 
+        # The thinking configuration for the fallback attempt that uses this `fallbacks`
+        # entry's `model`. If you leave it out, the attempt uses the request's `thinking`
+        # when `model` supports that thinking `type`.
+        #
+        # If you leave it out and the request's thinking `type` is `between_tools` but
+        # `model` doesn't support `between_tools`, the attempt uses `disabled` if `model`
+        # supports it. Otherwise, if `model` doesn't support the request's thinking
+        # `type`, if the request doesn't set `thinking`, or if you set this field to
+        # `null`, the attempt uses the thinking `type` that `model` uses when a request
+        # leaves out `thinking`. The request's `thinking.display` still applies where
+        # `model` allows it.
+        #
+        # These rules apply with the `server-side-fallback-2026-07-01` beta header.
+        #
         # @see Anthropic::Models::Beta::BetaFallbackParam#thinking
         module Thinking
           extend Anthropic::Internal::Type::Union

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

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

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

@@ -6,29 +6,34 @@ module Anthropic
       # @see Anthropic::Resources::Beta::MemoryStores#create
       class BetaManagedAgentsMemoryStore < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   Unique identifier for the memory store (a `memstore_...` tagged ID). Use this
-        #   when attaching the store to a session, or in the `{memory_store_id}` path
-        #   parameter of subsequent calls.
+        #   The unique ID of the memory store (`memstore_...`). Use it to attach the store
+        #   to a session.
         #
         #   @return [String]
         required :id, String
 
         # @!attribute archived_at
-        #   Timestamp when the store was archived, or `null` if active. Set once and never
-        #   cleared; archiving is one-way. Archived stores are read-only and cannot be
-        #   attached to new sessions.
+        #   When the memory store was archived, in RFC 3339, or `null` if it hasn't been.
+        #
+        #   Archiving can't be undone. An archived store can't be attached to new sessions.
+        #   You can't create or update its memories or update the store. You can still read
+        #   and delete its memories, redact their versions, and delete the store.
+        #
+        #   See the
+        #   [memory guide](https://platform.claude.com/docs/en/managed-agents/memory#archive-a-store)
+        #   to learn more about archiving.
         #
         #   @return [Time, nil]
         required :archived_at, Time, nil?: true
 
         # @!attribute created_at
-        #   Timestamp when the store was created.
+        #   When the memory store was created, in RFC 3339.
         #
         #   @return [Time]
         required :created_at, Time
 
         # @!attribute description
-        #   Free-text description of what the store contains, up to 1024 characters.
+        #   Free-text description of what the store contains, up to 1,024 characters.
         #   Included in the agent's system prompt when the store is attached, so word it to
         #   be useful to the agent. Empty string when unset.
         #
@@ -36,9 +41,11 @@ module Anthropic
         required :description, String
 
         # @!attribute metadata
-        #   Arbitrary key-value tags for your own bookkeeping (such as the end user a store
-        #   belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters.
-        #   Returned on retrieve/list but not filterable.
+        #   Key-value pairs for your own use, such as the end user that the store belongs
+        #   to.
+        #
+        #   A store has at most 16 pairs. Keys are 1 to 64 characters long and values at
+        #   most 512 characters. You can't filter lists by metadata.
         #
         #   @return [Hash{Symbol=>String}]
         required :metadata, Anthropic::Internal::Type::HashOf[String]
@@ -56,8 +63,10 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsMemoryStore::Type }
 
         # @!attribute updated_at
-        #   Timestamp when the store's `name`, `description`, or `metadata` was last
-        #   modified. Memory writes inside the store do not advance this.
+        #   When the memory store was last changed, in RFC 3339.
+        #
+        #   Changing its `name`, `description`, or `metadata` updates it. Archiving the
+        #   store does too. Changes to the store's memories don't.
         #
         #   @return [Time]
         required :updated_at, Time
@@ -70,21 +79,21 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaManagedAgentsMemoryStore} for more details.
         #
-        #   @param id [String] Unique identifier for the memory store (a `memstore_...` tagged ID). Use this wh
+        #   @param id [String] The unique ID of the memory store (`memstore_...`). Use it to attach the store t
         #
-        #   @param archived_at [Time, nil] Timestamp when the store was archived, or `null` if active. Set once and never c
+        #   @param archived_at [Time, nil] When the memory store was archived, in RFC 3339, or `null` if it hasn't been.
         #
-        #   @param created_at [Time] Timestamp when the store was created.
+        #   @param created_at [Time] When the memory store was created, in RFC 3339.
         #
-        #   @param description [String] Free-text description of what the store contains, up to 1024 characters. Include
+        #   @param description [String] Free-text description of what the store contains, up to 1,024 characters. Includ
         #
-        #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value tags for your own bookkeeping (such as the end user a store
+        #   @param metadata [Hash{Symbol=>String}] Key-value pairs for your own use, such as the end user that the store belongs to
         #
         #   @param name [String] Human-readable name for the store. 1–255 characters. The store's mount-path slug
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsMemoryStore::Type]
         #
-        #   @param updated_at [Time] Timestamp when the store's `name`, `description`, or `metadata` was last modifie
+        #   @param updated_at [Time] When the memory store was last changed, in RFC 3339.
 
         # @see Anthropic::Models::Beta::BetaManagedAgentsMemoryStore#type
         module Type

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

@@ -6,7 +6,7 @@ module Anthropic
       # @see Anthropic::Resources::Beta::Vaults#create
       class BetaManagedAgentsVault < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   Unique identifier for the vault.
+        #   The unique ID of the vault (`vlt_...`).
         #
         #   @return [String]
         required :id, String
@@ -49,7 +49,7 @@ module Anthropic
         # @!method initialize(id:, archived_at:, created_at:, display_name:, metadata:, type:, updated_at:)
         #   A vault that stores credentials for use by agents during sessions.
         #
-        #   @param id [String] Unique identifier for the vault.
+        #   @param id [String] The unique ID of the vault (`vlt_...`).
         #
         #   @param archived_at [Time, nil] When the vault was archived. Null if not archived.
         #

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

@@ -24,6 +24,15 @@ module Anthropic
         #   @return [Hash{Symbol=>String}]
         required :metadata, Anthropic::Internal::Type::HashOf[String]
 
+        # @!attribute name
+        #   Real-world name of the entity this profile represents (company or individual).
+        #   For a company the platform resells Claude access to (`access_type`
+        #   `passthrough`) this is that company's name. `null` until the platform supplies
+        #   one.
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
         # @!attribute trust_grants
         #   Trust grants for this profile, keyed by grant name. Key omitted when no grant is
         #   active or in flight.
@@ -39,34 +48,36 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaUserProfile::Type }
 
         # @!attribute updated_at
-        #   When this user profile was last modified, in RFC 3339 format. Trust-grant status
-        #   changes also bump this timestamp.
+        #   When this user profile was last modified, in RFC 3339 format. It normally also
+        #   updates shortly after Anthropic gives the profile an approval or withdraws one.
+        #   Other changes to the statuses that Anthropic reports do not always update it, so
+        #   read the status itself rather than watching this timestamp.
         #
         #   @return [Time]
         required :updated_at, Time
 
         # @!attribute access_type
         #   How the platform uses the API for this entity: `application` (default) or
-        #   `passthrough`. Present under the `user-profiles-2026-08-18` and later beta
-        #   headers.
+        #   `passthrough`. Absent under the legacy `user-profiles-2026-03-24` beta header.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaUserProfile::AccessType, nil]
         optional :access_type, enum: -> { Anthropic::Beta::BetaUserProfile::AccessType }
 
         # @!attribute external_id
-        #   Platform's own identifier for this user. Not enforced unique. Present under the
-        #   `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; under
-        #   `user-profiles-2026-09-04` the value is `external_user_details.reference_id`.
+        #   Platform's own identifier for this user. Not enforced unique. Legacy field,
+        #   present only under the `user-profiles-2026-03-24` and `user-profiles-2026-08-18`
+        #   beta headers; without one of them, the value is
+        #   `external_user_details.reference_id`.
         #
         #   @return [String, nil]
         optional :external_id, String, nil?: true
 
         # @!attribute external_user_details
         #   Details about the entity this profile represents, as the platform states them;
-        #   not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta
-        #   header, with every field present and `null` until the platform supplies a value;
-        #   the earlier beta headers serve `reference_id` as the top-level `external_id`,
-        #   and `user-profiles-2026-08-18` serves `onboarded_at` as
+        #   not verified by Anthropic. Every field is present, `null` until the platform
+        #   supplies a value. Absent under the legacy `user-profiles-2026-03-24` and
+        #   `user-profiles-2026-08-18` beta headers, which serve `reference_id` as the
+        #   top-level `external_id` and, under `user-profiles-2026-08-18`, `onboarded_at` as
         #   `external_user_onboarded_at`.
         #
         #   @return [Anthropic::Models::Beta::BetaUserProfileExternalUserDetails, nil]
@@ -75,21 +86,14 @@ module Anthropic
         # @!attribute external_user_onboarded_at
         #   When the entity this profile represents opened its account with the platform, as
         #   stated by the platform, in RFC 3339 format (UTC). `null` until the platform
-        #   supplies one. Present under the `user-profiles-2026-08-18` beta header; under
-        #   `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
+        #   supplies one. Legacy field, present only under the `user-profiles-2026-08-18`
+        #   beta header; without a legacy header, the value is
+        #   `external_user_details.onboarded_at`.
         #
         #   @return [Time, nil]
         optional :external_user_onboarded_at, Time, nil?: true
 
-        # @!attribute name
-        #   Real-world name of the entity this profile represents (company or individual).
-        #   For a company the platform resells Claude access to (`access_type`
-        #   `passthrough`) this is that company's name.
-        #
-        #   @return [String, nil]
-        optional :name, String, nil?: true
-
-        # @!method initialize(id:, created_at:, metadata:, trust_grants:, type:, updated_at:, access_type: nil, external_id: nil, external_user_details: nil, external_user_onboarded_at: nil, name: nil)
+        # @!method initialize(id:, created_at:, metadata:, name:, trust_grants:, type:, updated_at:, access_type: nil, external_id: nil, external_user_details: nil, external_user_onboarded_at: nil)
         #   A record of an entity that the platform serves through the API, such as an
         #   end-user of the platform's product or a company that the platform resells Claude
         #   access to.
@@ -107,21 +111,21 @@ module Anthropic
         #
         #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up t
         #
+        #   @param name [String, nil] Real-world name of the entity this profile represents (company or individual). F
+        #
         #   @param trust_grants [Hash{Symbol=>Anthropic::Models::Beta::BetaUserProfileTrustGrant}] Trust grants for this profile, keyed by grant name. Key omitted when no grant is
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaUserProfile::Type] Object type. Always `user_profile`.
         #
-        #   @param updated_at [Time] When this user profile was last modified, in RFC 3339 format. Trust-grant status
+        #   @param updated_at [Time] When this user profile was last modified, in RFC 3339 format. It normally also u
         #
         #   @param access_type [Symbol, Anthropic::Models::Beta::BetaUserProfile::AccessType] How the platform uses the API for this entity: `application` (default) or `passt
         #
-        #   @param external_id [String, nil] Platform's own identifier for this user. Not enforced unique. Present under the
+        #   @param external_id [String, nil] Platform's own identifier for this user. Not enforced unique. Legacy field, pres
         #
         #   @param external_user_details [Anthropic::Models::Beta::BetaUserProfileExternalUserDetails] Details about the entity this profile represents, as the platform states them; n
         #
         #   @param external_user_onboarded_at [Time, nil] When the entity this profile represents opened its account with the platform, as
-        #
-        #   @param name [String, nil] Real-world name of the entity this profile represents (company or individual). F
 
         # Object type. Always `user_profile`.
         #
@@ -136,8 +140,7 @@ module Anthropic
         end
 
         # How the platform uses the API for this entity: `application` (default) or
-        # `passthrough`. Present under the `user-profiles-2026-08-18` and later beta
-        # headers.
+        # `passthrough`. Absent under the legacy `user-profiles-2026-03-24` beta header.
         #
         # @see Anthropic::Models::Beta::BetaUserProfile#access_type
         module AccessType

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

@@ -25,7 +25,7 @@ module Anthropic
 
         # @!method initialize(expires_at:, type:, url:)
         #   A URL to give to the entity that a user profile represents, so that the entity
-        #   can enroll for a trust grant.
+        #   can enroll in a program.
         #
         #   @param expires_at [Time] When this enrollment URL expires, in RFC 3339 format.
         #

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

@@ -9,9 +9,10 @@ module Anthropic
         include Anthropic::Internal::Type::RequestParameters
 
         # @!attribute memory_store_id
-        #   ID of the memory store to archive (a `memstore_...` identifier). Required.
-        #   Archiving is one-way and idempotent; archived stores cannot be unarchived.
-        #   Enumerate IDs via `GET /v1/memory_stores`.
+        #   The ID of the memory store to archive (`memstore_...`).
+        #
+        #   Archiving can't be undone. Archiving a store that is already archived returns it
+        #   unchanged.
         #
         #   @return [String]
         required :memory_store_id, String
@@ -38,7 +39,7 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::MemoryStoreArchiveParams} for more details.
         #
-        #   @param memory_store_id [String] ID of the memory store to archive (a `memstore_...` identifier). Required. Archi
+        #   @param memory_store_id [String] The ID of the memory store to archive (`memstore_...`).
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] This endpoint is in beta: requests must send `agent-memory-2026-07-22` or `manag
         #

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

@@ -9,16 +9,23 @@ module Anthropic
         include Anthropic::Internal::Type::RequestParameters
 
         # @!attribute name
-        #   Human-readable name for the store. Required; 1–255 characters; no control
-        #   characters. The mount-path slug under `/mnt/memory/` is derived from this name
-        #   (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need not be
-        #   unique within a workspace.
+        #   The name of the memory store, 1 to 255 characters long, without control
+        #   characters. Names don't have to be unique in a workspace.
+        #
+        #   In a session, the store's directory under `/mnt/memory/` is based on this name.
+        #   The name is lowercased and every run of characters other than ASCII letters and
+        #   digits becomes one hyphen. The session's memory store resource gives the exact
+        #   path in `mount_path`.
+        #
+        #   See the
+        #   [memory guide](https://platform.claude.com/docs/en/managed-agents/memory#how-the-agent-accesses-memory)
+        #   to learn more about how agents access memory stores.
         #
         #   @return [String]
         required :name, String
 
         # @!attribute description
-        #   Free-text description of what the store contains, up to 1024 characters.
+        #   Free-text description of what the store contains, up to 1,024 characters.
         #   Included in the agent's system prompt when the store is attached, so word it to
         #   be useful to the agent.
         #
@@ -26,9 +33,11 @@ module Anthropic
         optional :description, String
 
         # @!attribute metadata
-        #   Arbitrary key-value tags for your own bookkeeping (such as the end user a store
-        #   belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters.
-        #   Not visible to the agent.
+        #   Key-value pairs for your own use, such as the end user that the store belongs
+        #   to. The agent doesn't see them.
+        #
+        #   A store has at most 16 pairs. Keys are 1 to 64 characters long and values at
+        #   most 512 characters.
         #
         #   @return [Hash{Symbol=>String}, nil]
         optional :metadata, Anthropic::Internal::Type::HashOf[String]
@@ -55,11 +64,11 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::MemoryStoreCreateParams} for more details.
         #
-        #   @param name [String] Human-readable name for the store. Required; 1–255 characters; no control charac
+        #   @param name [String] The name of the memory store, 1 to 255 characters long, without control characte
         #
-        #   @param description [String] Free-text description of what the store contains, up to 1024 characters. Include
+        #   @param description [String] Free-text description of what the store contains, up to 1,024 characters. Includ
         #
-        #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value tags for your own bookkeeping (such as the end user a store
+        #   @param metadata [Hash{Symbol=>String}] Key-value pairs for your own use, such as the end user that the store belongs to
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] This endpoint is in beta: requests must send `agent-memory-2026-07-22` or `manag
         #

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

@@ -9,9 +9,10 @@ module Anthropic
         include Anthropic::Internal::Type::RequestParameters
 
         # @!attribute memory_store_id
-        #   ID of the memory store to permanently delete (a `memstore_...` identifier).
-        #   Required. Deletion cascades to all memories and memory versions in the store and
-        #   cannot be undone.
+        #   The ID of the memory store to delete (`memstore_...`).
+        #
+        #   Deleting a store also deletes all its memories and memory versions. It can't be
+        #   undone.
         #
         #   @return [String]
         required :memory_store_id, String
@@ -38,7 +39,7 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::MemoryStoreDeleteParams} for more details.
         #
-        #   @param memory_store_id [String] ID of the memory store to permanently delete (a `memstore_...` identifier). Requ
+        #   @param memory_store_id [String] The ID of the memory store to delete (`memstore_...`).
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] This endpoint is in beta: requests must send `agent-memory-2026-07-22` or `manag
         #