feat(api): add lifecycle stage fields and filter to /v1/models

Stainless-Generated-From: 882eb6e6e3f80bf33b1a00ef35d2a4388b73a0ff

Author: anthropic-sdks-writer[bot]

lib/anthropic/models/beta/beta_model_info.rb

@@ -33,12 +33,34 @@ class BetaModelInfo < Anthropic::Internal::Type::BaseModel
         #   @return [Time]
         required :created_at, Time
 
+        # @!attribute deprecated_at
+        #   RFC 3339 datetime string representing the time of the model's most recent
+        #   deprecation. Populated for `deprecated` and `retired` models; `null` while the
+        #   model is `active`.
+        #
+        #   @return [Time, nil]
+        required :deprecated_at, Time, nil?: true
+
         # @!attribute display_name
         #   A human-readable name for the model.
         #
         #   @return [String]
         required :display_name, String
 
+        # @!attribute lifecycle
+        #   The model's current lifecycle stage.
+        #
+        #   - `active`: The model is available for use, open to new adopters, and not
+        #     scheduled for retirement.
+        #   - `deprecated`: The model remains callable for organizations with existing
+        #     access, but is headed for retirement and closed to new adopters.
+        #   - `retired`: The model is no longer available for use; inference requests naming
+        #     it fail. It remains in the catalogue as the historical record of its
+        #     retirement.
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaModelInfo::Lifecycle]
+        required :lifecycle, enum: -> { Anthropic::Beta::BetaModelInfo::Lifecycle }
+
         # @!attribute line
         #   The model line this model belongs to, such as `opus` for both Claude Opus 4.5
         #   and Claude Opus 4.6. More lines may be added. `null` when the model belongs to
@@ -59,6 +81,16 @@ class BetaModelInfo < Anthropic::Internal::Type::BaseModel
         #   @return [Integer, nil]
         required :max_tokens, Integer, nil?: true
 
+        # @!attribute retires_at
+        #   RFC 3339 datetime string representing the model's currently scheduled retirement
+        #   date. The schedule can be revised until retirement occurs; `null` while the
+        #   model is `active` or while no retirement is scheduled. A past date on a
+        #   `deprecated` model means retirement is overdue, not that it has occurred:
+        #   `lifecycle` is the retirement signal.
+        #
+        #   @return [Time, nil]
+        required :retires_at, Time, nil?: true
+
         # @!attribute type
         #   Object type.
         #
@@ -67,7 +99,7 @@ class BetaModelInfo < Anthropic::Internal::Type::BaseModel
         #   @return [Symbol, :model]
         required :type, const: :model
 
-        # @!method initialize(id:, allowed_fallback_models:, capabilities:, created_at:, display_name:, line:, max_input_tokens:, max_tokens:, type: :model)
+        # @!method initialize(id:, allowed_fallback_models:, capabilities:, created_at:, deprecated_at:, display_name:, lifecycle:, line:, max_input_tokens:, max_tokens:, retires_at:, type: :model)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaModelInfo} for more details.
         #
@@ -79,15 +111,43 @@ class BetaModelInfo < Anthropic::Internal::Type::BaseModel
         #
         #   @param created_at [Time] RFC 3339 datetime string representing the time at which the model was released.
         #
+        #   @param deprecated_at [Time, nil] RFC 3339 datetime string representing the time of the model's most recent deprec
+        #
         #   @param display_name [String] A human-readable name for the model.
         #
+        #   @param lifecycle [Symbol, Anthropic::Models::Beta::BetaModelInfo::Lifecycle] The model's current lifecycle stage.
+        #
         #   @param line [Symbol, Anthropic::Models::Beta::BetaModelLine, nil] The model line this model belongs to, such as `opus` for both Claude Opus 4.5 an
         #
         #   @param max_input_tokens [Integer, nil] Maximum input context window size in tokens for this model.
         #
         #   @param max_tokens [Integer, nil] Maximum value for the `max_tokens` parameter when using this model.
         #
+        #   @param retires_at [Time, nil] RFC 3339 datetime string representing the model's currently scheduled retirement
+        #
         #   @param type [Symbol, :model] Object type.
+
+        # The model's current lifecycle stage.
+        #
+        # - `active`: The model is available for use, open to new adopters, and not
+        #   scheduled for retirement.
+        # - `deprecated`: The model remains callable for organizations with existing
+        #   access, but is headed for retirement and closed to new adopters.
+        # - `retired`: The model is no longer available for use; inference requests naming
+        #   it fail. It remains in the catalogue as the historical record of its
+        #   retirement.
+        #
+        # @see Anthropic::Models::Beta::BetaModelInfo#lifecycle
+        module Lifecycle
+          extend Anthropic::Internal::Type::Enum
+
+          ACTIVE = :active
+          DEPRECATED = :deprecated
+          RETIRED = :retired
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
 

lib/anthropic/models/beta/model_list_params.rb

@@ -22,6 +22,16 @@ class ModelListParams < Anthropic::Internal::Type::BaseModel
         #   @return [String, nil]
         optional :before_id, String
 
+        # @!attribute lifecycle
+        #   Filter the list to models in any of the given lifecycle stages (`active`,
+        #   `deprecated`, or `retired`). Up to 3 values. When omitted, the list contains the
+        #   `active` and `deprecated` models; `retired` models appear only when `retired` is
+        #   requested explicitly.
+        #
+        #   @return [Array<Symbol, Anthropic::Models::Beta::ModelListParams::Lifecycle>, nil]
+        optional :lifecycle,
+                 -> { Anthropic::Internal::Type::ArrayOf[enum: Anthropic::Beta::ModelListParams::Lifecycle] }
+
         # @!attribute limit
         #   Number of items to return per page.
         #
@@ -47,21 +57,34 @@ class ModelListParams < Anthropic::Internal::Type::BaseModel
         #   @return [String, nil]
         optional :workspace_id, String
 
-        # @!method initialize(after_id: nil, before_id: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
+        # @!method initialize(after_id: nil, before_id: nil, lifecycle: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::ModelListParams} for more details.
         #
         #   @param after_id [String] ID of the object to use as a cursor for pagination. When provided, returns the p
         #
         #   @param before_id [String] ID of the object to use as a cursor for pagination. When provided, returns the p
         #
+        #   @param lifecycle [Array<Symbol, Anthropic::Models::Beta::ModelListParams::Lifecycle>] Filter the list to models in any of the given lifecycle stages (`active`, `depre
+        #
         #   @param limit [Integer] Number of items to return per page.
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
         #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+
+        module Lifecycle
+          extend Anthropic::Internal::Type::Enum
+
+          ACTIVE = :active
+          DEPRECATED = :deprecated
+          RETIRED = :retired
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

lib/anthropic/models/model_info.rb

@@ -24,12 +24,34 @@ class ModelInfo < Anthropic::Internal::Type::BaseModel
       #   @return [Time]
       required :created_at, Time
 
+      # @!attribute deprecated_at
+      #   RFC 3339 datetime string representing the time of the model's most recent
+      #   deprecation. Populated for `deprecated` and `retired` models; `null` while the
+      #   model is `active`.
+      #
+      #   @return [Time, nil]
+      required :deprecated_at, Time, nil?: true
+
       # @!attribute display_name
       #   A human-readable name for the model.
       #
       #   @return [String]
       required :display_name, String
 
+      # @!attribute lifecycle
+      #   The model's current lifecycle stage.
+      #
+      #   - `active`: The model is available for use, open to new adopters, and not
+      #     scheduled for retirement.
+      #   - `deprecated`: The model remains callable for organizations with existing
+      #     access, but is headed for retirement and closed to new adopters.
+      #   - `retired`: The model is no longer available for use; inference requests naming
+      #     it fail. It remains in the catalogue as the historical record of its
+      #     retirement.
+      #
+      #   @return [Symbol, Anthropic::Models::ModelInfo::Lifecycle]
+      required :lifecycle, enum: -> { Anthropic::ModelInfo::Lifecycle }
+
       # @!attribute line
       #   The model line this model belongs to, such as `opus` for both Claude Opus 4.5
       #   and Claude Opus 4.6. More lines may be added. `null` when the model belongs to
@@ -50,6 +72,16 @@ class ModelInfo < Anthropic::Internal::Type::BaseModel
       #   @return [Integer, nil]
       required :max_tokens, Integer, nil?: true
 
+      # @!attribute retires_at
+      #   RFC 3339 datetime string representing the model's currently scheduled retirement
+      #   date. The schedule can be revised until retirement occurs; `null` while the
+      #   model is `active` or while no retirement is scheduled. A past date on a
+      #   `deprecated` model means retirement is overdue, not that it has occurred:
+      #   `lifecycle` is the retirement signal.
+      #
+      #   @return [Time, nil]
+      required :retires_at, Time, nil?: true
+
       # @!attribute type
       #   Object type.
       #
@@ -58,7 +90,7 @@ class ModelInfo < Anthropic::Internal::Type::BaseModel
       #   @return [Symbol, :model]
       required :type, const: :model
 
-      # @!method initialize(id:, capabilities:, created_at:, display_name:, line:, max_input_tokens:, max_tokens:, type: :model)
+      # @!method initialize(id:, capabilities:, created_at:, deprecated_at:, display_name:, lifecycle:, line:, max_input_tokens:, max_tokens:, retires_at:, type: :model)
       #   Some parameter documentations has been truncated, see
       #   {Anthropic::Models::ModelInfo} for more details.
       #
@@ -68,15 +100,43 @@ class ModelInfo < Anthropic::Internal::Type::BaseModel
       #
       #   @param created_at [Time] RFC 3339 datetime string representing the time at which the model was released.
       #
+      #   @param deprecated_at [Time, nil] RFC 3339 datetime string representing the time of the model's most recent deprec
+      #
       #   @param display_name [String] A human-readable name for the model.
       #
+      #   @param lifecycle [Symbol, Anthropic::Models::ModelInfo::Lifecycle] The model's current lifecycle stage.
+      #
       #   @param line [Symbol, Anthropic::Models::ModelLine, nil] The model line this model belongs to, such as `opus` for both Claude Opus 4.5 an
       #
       #   @param max_input_tokens [Integer, nil] Maximum input context window size in tokens for this model.
       #
       #   @param max_tokens [Integer, nil] Maximum value for the `max_tokens` parameter when using this model.
       #
+      #   @param retires_at [Time, nil] RFC 3339 datetime string representing the model's currently scheduled retirement
+      #
       #   @param type [Symbol, :model] Object type.
+
+      # The model's current lifecycle stage.
+      #
+      # - `active`: The model is available for use, open to new adopters, and not
+      #   scheduled for retirement.
+      # - `deprecated`: The model remains callable for organizations with existing
+      #   access, but is headed for retirement and closed to new adopters.
+      # - `retired`: The model is no longer available for use; inference requests naming
+      #   it fail. It remains in the catalogue as the historical record of its
+      #   retirement.
+      #
+      # @see Anthropic::Models::ModelInfo#lifecycle
+      module Lifecycle
+        extend Anthropic::Internal::Type::Enum
+
+        ACTIVE = :active
+        DEPRECATED = :deprecated
+        RETIRED = :retired
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

lib/anthropic/models/model_list_params.rb

@@ -21,6 +21,16 @@ class ModelListParams < Anthropic::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :before_id, String
 
+      # @!attribute lifecycle
+      #   Filter the list to models in any of the given lifecycle stages (`active`,
+      #   `deprecated`, or `retired`). Up to 3 values. When omitted, the list contains the
+      #   `active` and `deprecated` models; `retired` models appear only when `retired` is
+      #   requested explicitly.
+      #
+      #   @return [Array<Symbol, Anthropic::Models::ModelListParams::Lifecycle>, nil]
+      optional :lifecycle,
+               -> { Anthropic::Internal::Type::ArrayOf[enum: Anthropic::ModelListParams::Lifecycle] }
+
       # @!attribute limit
       #   Number of items to return per page.
       #
@@ -50,21 +60,34 @@ class ModelListParams < Anthropic::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :workspace_id, String
 
-      # @!method initialize(after_id: nil, before_id: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
+      # @!method initialize(after_id: nil, before_id: nil, lifecycle: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Anthropic::Models::ModelListParams} for more details.
       #
       #   @param after_id [String] ID of the object to use as a cursor for pagination. When provided, returns the p
       #
       #   @param before_id [String] ID of the object to use as a cursor for pagination. When provided, returns the p
       #
+      #   @param lifecycle [Array<Symbol, Anthropic::Models::ModelListParams::Lifecycle>] Filter the list to models in any of the given lifecycle stages (`active`, `depre
+      #
       #   @param limit [Integer] Number of items to return per page.
       #
       #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
       #
       #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
       #
       #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+
+      module Lifecycle
+        extend Anthropic::Internal::Type::Enum
+
+        ACTIVE = :active
+        DEPRECATED = :deprecated
+        RETIRED = :retired
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

lib/anthropic/resources/beta/models.rb

@@ -44,12 +44,14 @@ def retrieve(model_id, params = {})
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::ModelListParams} for more details.
         #
-        # @overload list(after_id: nil, before_id: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
+        # @overload list(after_id: nil, before_id: nil, lifecycle: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
         #
         # @param after_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
         #
         # @param before_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
         #
+        # @param lifecycle [Array<Symbol, Anthropic::Models::Beta::ModelListParams::Lifecycle>] Query param: Filter the list to models in any of the given lifecycle stages (`ac
+        #
         # @param limit [Integer] Query param: Number of items to return per page.
         #
         # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
@@ -62,7 +64,7 @@ def retrieve(model_id, params = {})
         #
         # @see Anthropic::Models::Beta::ModelListParams
         def list(params = {})
-          query_params = [:after_id, :before_id, :limit]
+          query_params = [:after_id, :before_id, :lifecycle, :limit]
           parsed, options = Anthropic::Beta::ModelListParams.dump_request(params)
           query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
           @client.request(

lib/anthropic/resources/models.rb

@@ -43,12 +43,14 @@ def retrieve(model_id, params = {})
       # Some parameter documentations has been truncated, see
       # {Anthropic::Models::ModelListParams} for more details.
       #
-      # @overload list(after_id: nil, before_id: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
+      # @overload list(after_id: nil, before_id: nil, lifecycle: nil, limit: nil, betas: nil, workspace_id: nil, request_options: {})
       #
       # @param after_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
       #
       # @param before_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
       #
+      # @param lifecycle [Array<Symbol, Anthropic::Models::ModelListParams::Lifecycle>] Query param: Filter the list to models in any of the given lifecycle stages (`ac
+      #
       # @param limit [Integer] Query param: Number of items to return per page.
       #
       # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
@@ -61,7 +63,7 @@ def retrieve(model_id, params = {})
       #
       # @see Anthropic::Models::ModelListParams
       def list(params = {})
-        query_params = [:after_id, :before_id, :limit]
+        query_params = [:after_id, :before_id, :lifecycle, :limit]
         parsed, options = Anthropic::ModelListParams.dump_request(params)
         query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
         @client.request(