anthropic 2.2.0 → 2.4.0

data/rbi/anthropic/models/organization/analytics_user_activity.rbi

@@ -0,0 +1,259 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsUserActivity < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsUserActivity,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Claude.ai activity metrics for a single user on a given day.
+        sig { returns(Anthropic::Organization::AnalyticsChatMetrics) }
+        attr_reader :chat_metrics
+
+        sig do
+          params(
+            chat_metrics: Anthropic::Organization::AnalyticsChatMetrics::OrHash
+          ).void
+        end
+        attr_writer :chat_metrics
+
+        # Claude Code activity metrics for a single user on a given day.
+        sig { returns(Anthropic::Organization::AnalyticsClaudeCodeMetrics) }
+        attr_reader :claude_code_metrics
+
+        sig do
+          params(
+            claude_code_metrics:
+              Anthropic::Organization::AnalyticsClaudeCodeMetrics::OrHash
+          ).void
+        end
+        attr_writer :claude_code_metrics
+
+        # Cowork activity metrics for a single user on a given day.
+        sig { returns(Anthropic::Organization::AnalyticsCoworkMetrics) }
+        attr_reader :cowork_metrics
+
+        sig do
+          params(
+            cowork_metrics:
+              Anthropic::Organization::AnalyticsCoworkMetrics::OrHash
+          ).void
+        end
+        attr_writer :cowork_metrics
+
+        # Claude Design activity metrics for a single user on a given day.
+        sig { returns(Anthropic::Organization::AnalyticsDesignMetrics) }
+        attr_reader :design_metrics
+
+        sig do
+          params(
+            design_metrics:
+              Anthropic::Organization::AnalyticsDesignMetrics::OrHash
+          ).void
+        end
+        attr_writer :design_metrics
+
+        # Number of distinct active users represented by this row. Only set for grouped
+        # rollups (`group_by[]`); null for per-user rows. In date-range mode, recomputed
+        # as an exact distinct count of the group's active members over the requested
+        # window, never a sum of per-day values.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :distinct_user_count
+
+        # Office Agent activity metrics for a single user on a given day, broken out by
+        # Office product.
+        sig { returns(Anthropic::Organization::AnalyticsOfficeMetrics) }
+        attr_reader :office_metrics
+
+        sig do
+          params(
+            office_metrics:
+              Anthropic::Organization::AnalyticsOfficeMetrics::OrHash
+          ).void
+        end
+        attr_writer :office_metrics
+
+        # Claude Science activity metrics for a single user on a given day.
+        sig { returns(Anthropic::Organization::AnalyticsScienceMetrics) }
+        attr_reader :science_metrics
+
+        sig do
+          params(
+            science_metrics:
+              Anthropic::Organization::AnalyticsScienceMetrics::OrHash
+          ).void
+        end
+        attr_writer :science_metrics
+
+        # The user this row describes. Null on rows aggregated across users.
+        sig { returns(T.nilable(Anthropic::Organization::AnalyticsUser)) }
+        attr_reader :user
+
+        sig do
+          params(
+            user: T.nilable(Anthropic::Organization::AnalyticsUser::OrHash)
+          ).void
+        end
+        attr_writer :user
+
+        # Number of web searches performed
+        sig { returns(Integer) }
+        attr_accessor :web_search_count
+
+        # Activity recorded while the member had Chat and Cowork unified (Cowork's
+        # features inside claude.ai chat) turned on, split into `chat` (chat activity) and
+        # `sessions` (Cowork activity). Omitted from the response on deployments that do
+        # not offer Chat and Cowork unified.
+        sig do
+          returns(
+            T.nilable(
+              Anthropic::Organization::AnalyticsChatCoworkUnifiedMetrics
+            )
+          )
+        end
+        attr_reader :chat_cowork_unified_metrics
+
+        sig do
+          params(
+            chat_cowork_unified_metrics:
+              T.nilable(
+                Anthropic::Organization::AnalyticsChatCoworkUnifiedMetrics::OrHash
+              )
+          ).void
+        end
+        attr_writer :chat_cowork_unified_metrics
+
+        # Most recent UTC day (YYYY-MM-DD) on which the user had any counted activity,
+        # within the requested window: equal to the requested `date` in single-day mode,
+        # and to the latest active day from `starting_date` (inclusive) to `ending_date`
+        # (exclusive) in date-range rollup mode — never a day earlier than the window
+        # start. On filtered requests (`filter[]`) only days matching the filter count:
+        # with `filter[]=rbac_group_id:{id}` it is the last day the user was active while
+        # a member of that group, consistent with the row's other metrics. On grouped
+        # (`group_by[]`) rows it is the latest day any member of the group was active (the
+        # requested `date` in single-day mode). Omitted from the response while
+        # last-activity reporting is not enabled for this organization.
+        sig { returns(T.nilable(Date)) }
+        attr_accessor :last_activity_date
+
+        # Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API
+        # spelling. Present only when the request grouped by `rbac_group_id`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :rbac_group_id
+
+        # Resolved RBAC group display name, alongside `rbac_group_id` when name resolution
+        # is available. Null if the group has been deleted or its name could not be
+        # resolved; `rbac_group_id` remains the stable key.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :rbac_group_name
+
+        # Per-user activity data for a given day.
+        sig do
+          params(
+            chat_metrics: Anthropic::Organization::AnalyticsChatMetrics::OrHash,
+            claude_code_metrics:
+              Anthropic::Organization::AnalyticsClaudeCodeMetrics::OrHash,
+            cowork_metrics:
+              Anthropic::Organization::AnalyticsCoworkMetrics::OrHash,
+            design_metrics:
+              Anthropic::Organization::AnalyticsDesignMetrics::OrHash,
+            distinct_user_count: T.nilable(Integer),
+            office_metrics:
+              Anthropic::Organization::AnalyticsOfficeMetrics::OrHash,
+            science_metrics:
+              Anthropic::Organization::AnalyticsScienceMetrics::OrHash,
+            user: T.nilable(Anthropic::Organization::AnalyticsUser::OrHash),
+            web_search_count: Integer,
+            chat_cowork_unified_metrics:
+              T.nilable(
+                Anthropic::Organization::AnalyticsChatCoworkUnifiedMetrics::OrHash
+              ),
+            last_activity_date: T.nilable(Date),
+            rbac_group_id: T.nilable(String),
+            rbac_group_name: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Claude.ai activity metrics for a single user on a given day.
+          chat_metrics:,
+          # Claude Code activity metrics for a single user on a given day.
+          claude_code_metrics:,
+          # Cowork activity metrics for a single user on a given day.
+          cowork_metrics:,
+          # Claude Design activity metrics for a single user on a given day.
+          design_metrics:,
+          # Number of distinct active users represented by this row. Only set for grouped
+          # rollups (`group_by[]`); null for per-user rows. In date-range mode, recomputed
+          # as an exact distinct count of the group's active members over the requested
+          # window, never a sum of per-day values.
+          distinct_user_count:,
+          # Office Agent activity metrics for a single user on a given day, broken out by
+          # Office product.
+          office_metrics:,
+          # Claude Science activity metrics for a single user on a given day.
+          science_metrics:,
+          # The user this row describes. Null on rows aggregated across users.
+          user:,
+          # Number of web searches performed
+          web_search_count:,
+          # Activity recorded while the member had Chat and Cowork unified (Cowork's
+          # features inside claude.ai chat) turned on, split into `chat` (chat activity) and
+          # `sessions` (Cowork activity). Omitted from the response on deployments that do
+          # not offer Chat and Cowork unified.
+          chat_cowork_unified_metrics: nil,
+          # Most recent UTC day (YYYY-MM-DD) on which the user had any counted activity,
+          # within the requested window: equal to the requested `date` in single-day mode,
+          # and to the latest active day from `starting_date` (inclusive) to `ending_date`
+          # (exclusive) in date-range rollup mode — never a day earlier than the window
+          # start. On filtered requests (`filter[]`) only days matching the filter count:
+          # with `filter[]=rbac_group_id:{id}` it is the last day the user was active while
+          # a member of that group, consistent with the row's other metrics. On grouped
+          # (`group_by[]`) rows it is the latest day any member of the group was active (the
+          # requested `date` in single-day mode). Omitted from the response while
+          # last-activity reporting is not enabled for this organization.
+          last_activity_date: nil,
+          # Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API
+          # spelling. Present only when the request grouped by `rbac_group_id`.
+          rbac_group_id: nil,
+          # Resolved RBAC group display name, alongside `rbac_group_id` when name resolution
+          # is available. Null if the group has been deleted or its name could not be
+          # resolved; `rbac_group_id` remains the stable key.
+          rbac_group_name: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              chat_metrics: Anthropic::Organization::AnalyticsChatMetrics,
+              claude_code_metrics:
+                Anthropic::Organization::AnalyticsClaudeCodeMetrics,
+              cowork_metrics: Anthropic::Organization::AnalyticsCoworkMetrics,
+              design_metrics: Anthropic::Organization::AnalyticsDesignMetrics,
+              distinct_user_count: T.nilable(Integer),
+              office_metrics: Anthropic::Organization::AnalyticsOfficeMetrics,
+              science_metrics: Anthropic::Organization::AnalyticsScienceMetrics,
+              user: T.nilable(Anthropic::Organization::AnalyticsUser),
+              web_search_count: Integer,
+              chat_cowork_unified_metrics:
+                T.nilable(
+                  Anthropic::Organization::AnalyticsChatCoworkUnifiedMetrics
+                ),
+              last_activity_date: T.nilable(Date),
+              rbac_group_id: T.nilable(String),
+              rbac_group_name: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_user_group_by.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      # A dimension to group user activity by.
+      module AnalyticsUserGroupBy
+        extend Anthropic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Anthropic::Organization::AnalyticsUserGroupBy)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        RBAC_GROUP_ID =
+          T.let(
+            :rbac_group_id,
+            Anthropic::Organization::AnalyticsUserGroupBy::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Anthropic::Organization::AnalyticsUserGroupBy::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/aws_external_key_config.rbi

@@ -12,9 +12,9 @@ module Anthropic
             )
           end
 
-        # Full ARN of the AWS KMS key. On Claude Platform on AWS the key must be a
-        # single-Region key in your organization's own AWS account; cross-account keys,
-        # multi-Region keys, and alias ARNs are rejected.
+        # Full ARN of the AWS KMS key. On Claude Platform on AWS, alias ARNs are rejected,
+        # and your organization's own key must be a single-Region key in your
+        # organization's AWS account.
         sig { returns(String) }
         attr_accessor :kms_arn
 
@@ -33,9 +33,9 @@ module Anthropic
           ).returns(T.attached_class)
         end
         def self.new(
-          # Full ARN of the AWS KMS key. On Claude Platform on AWS the key must be a
-          # single-Region key in your organization's own AWS account; cross-account keys,
-          # multi-Region keys, and alias ARNs are rejected.
+          # Full ARN of the AWS KMS key. On Claude Platform on AWS, alias ARNs are rejected,
+          # and your organization's own key must be a single-Region key in your
+          # organization's AWS account.
           kms_arn:,
           # AWS region. Derived from `kms_arn` if omitted.
           region: nil,

data/rbi/anthropic/models/organization/deleted_rbac_group.rbi

@@ -0,0 +1,42 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class DeletedRBACGroup < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::DeletedRBACGroup,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # ID of the RBAC Group.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Deleted object type.
+        #
+        # For RBAC Groups, this is always `"rbac_group_deleted"`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { params(id: String, type: Symbol).returns(T.attached_class) }
+        def self.new(
+          # ID of the RBAC Group.
+          id:,
+          # Deleted object type.
+          #
+          # For RBAC Groups, this is always `"rbac_group_deleted"`.
+          type: :rbac_group_deleted
+        )
+        end
+
+        sig { override.returns({ id: String, type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/external_key.rbi

@@ -12,8 +12,8 @@ module Anthropic
             )
           end
 
-        # Identifier of the external key config. A tagged ID prefixed `ekey_`, or — for
-        # organizations on the Claude Platform on AWS — the AWS KMS key ARN.
+        # Identifier of the external key config: a tagged ID prefixed `ekey_`, or, on
+        # Claude Platform on AWS, an AWS KMS key's ARN.
         sig { returns(String) }
         attr_accessor :id
 
@@ -33,8 +33,8 @@ module Anthropic
         sig { returns(T.nilable(String)) }
         attr_accessor :display_name
 
-        # Data residency geo. Selects which regional validator handles this key's
-        # encrypt/decrypt roundtrips.
+        # Data residency geo. Selects the region that handles this key's encrypt/decrypt
+        # roundtrips.
         sig { returns(String) }
         attr_accessor :geo
 
@@ -52,6 +52,13 @@ module Anthropic
         sig { returns(Time) }
         attr_accessor :updated_at
 
+        # ID of the user profile the key is bound to, or null if the key is not bound to
+        # one. A key bound to a user profile can only be attached to a Workspace that has
+        # the same user profile. A key that isn't bound can be attached to a Workspace
+        # whatever its user profile.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :user_profile_id
+
         # CMEK external key config belonging to the caller's organization.
         #
         # Configs are organization-scoped. Workspaces attach to a config; once any
@@ -75,12 +82,13 @@ module Anthropic
                 Anthropic::Organization::AzureExternalKeyConfig::OrHash
               ),
             updated_at: Time,
+            user_profile_id: T.nilable(String),
             type: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
-          # Identifier of the external key config. A tagged ID prefixed `ekey_`, or — for
-          # organizations on the Claude Platform on AWS — the AWS KMS key ARN.
+          # Identifier of the external key config: a tagged ID prefixed `ekey_`, or, on
+          # Claude Platform on AWS, an AWS KMS key's ARN.
           id:,
           # Whether any workspace uses this config to encrypt its data — counting live and
           # archived workspaces (an archived workspace's data remains encrypted under the
@@ -90,12 +98,17 @@ module Anthropic
           created_at:,
           # Human-friendly display name. Null if none was set.
           display_name:,
-          # Data residency geo. Selects which regional validator handles this key's
-          # encrypt/decrypt roundtrips.
+          # Data residency geo. Selects the region that handles this key's encrypt/decrypt
+          # roundtrips.
           geo:,
           # KMS provider identity and auth coordinates.
           provider_config:,
           updated_at:,
+          # ID of the user profile the key is bound to, or null if the key is not bound to
+          # one. A key bound to a user profile can only be attached to a Workspace that has
+          # the same user profile. A key that isn't bound can be attached to a Workspace
+          # whatever its user profile.
+          user_profile_id:,
           type: :external_key
         )
         end
@@ -112,7 +125,8 @@ module Anthropic
               provider_config:
                 Anthropic::Organization::ExternalKey::ProviderConfig::Variants,
               type: Symbol,
-              updated_at: Time
+              updated_at: Time,
+              user_profile_id: T.nilable(String)
             }
           )
         end
@@ -272,9 +286,9 @@ module Anthropic
           end
           def self.new(
             type:,
-            # Full ARN of the AWS KMS key. On Claude Platform on AWS the key must be a
-            # single-Region key in your organization's own AWS account; cross-account keys,
-            # multi-Region keys, and alias ARNs are rejected.
+            # Full ARN of the AWS KMS key. On Claude Platform on AWS, alias ARNs are rejected,
+            # and your organization's own key must be a single-Region key in your
+            # organization's AWS account.
             kms_arn: nil,
             # AWS region. Derived from `kms_arn` if omitted.
             region: nil,

data/rbi/anthropic/models/organization/external_key_create_params.rbi

@@ -48,6 +48,13 @@ module Anthropic
         end
         attr_writer :geo
 
+        # ID of a user profile to bind the key to. Omit this field for a key that isn't
+        # bound to a user profile. Such a key can be attached to a Workspace whatever its
+        # user profile. The binding cannot be changed later. A key bound to a user profile
+        # can only be attached to a Workspace that has the same user profile.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :user_profile_id
+
         sig do
           params(
             provider_config:
@@ -59,6 +66,7 @@ module Anthropic
             display_name: T.nilable(String),
             geo:
               Anthropic::Organization::ExternalKeyCreateParams::Geo::OrSymbol,
+            user_profile_id: T.nilable(String),
             request_options: Anthropic::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -69,6 +77,11 @@ module Anthropic
           display_name: nil,
           # Data residency geo. Only `us` is supported.
           geo: nil,
+          # ID of a user profile to bind the key to. Omit this field for a key that isn't
+          # bound to a user profile. Such a key can be attached to a Workspace whatever its
+          # user profile. The binding cannot be changed later. A key bound to a user profile
+          # can only be attached to a Workspace that has the same user profile.
+          user_profile_id: nil,
           request_options: {}
         )
         end
@@ -85,6 +98,7 @@ module Anthropic
               display_name: T.nilable(String),
               geo:
                 Anthropic::Organization::ExternalKeyCreateParams::Geo::OrSymbol,
+              user_profile_id: T.nilable(String),
               request_options: Anthropic::RequestOptions
             }
           )
@@ -172,9 +186,9 @@ module Anthropic
           end
           def self.new(
             type:,
-            # Full ARN of the AWS KMS key. On Claude Platform on AWS the key must be a
-            # single-Region key in your organization's own AWS account; cross-account keys,
-            # multi-Region keys, and alias ARNs are rejected.
+            # Full ARN of the AWS KMS key. On Claude Platform on AWS, alias ARNs are rejected,
+            # and your organization's own key must be a single-Region key in your
+            # organization's AWS account.
             kms_arn: nil,
             # AWS region. Derived from `kms_arn` if omitted.
             region: nil,

data/rbi/anthropic/models/organization/external_key_update_params.rbi

@@ -213,9 +213,9 @@ module Anthropic
           end
           def self.new(
             type:,
-            # Full ARN of the AWS KMS key. On Claude Platform on AWS the key must be a
-            # single-Region key in your organization's own AWS account; cross-account keys,
-            # multi-Region keys, and alias ARNs are rejected.
+            # Full ARN of the AWS KMS key. On Claude Platform on AWS, alias ARNs are rejected,
+            # and your organization's own key must be a single-Region key in your
+            # organization's AWS account.
             kms_arn: nil,
             # AWS region. Derived from `kms_arn` if omitted.
             region: nil,

data/rbi/anthropic/models/organization/rbac_group.rbi

@@ -0,0 +1,140 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class RBACGroup < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::RBACGroup,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # ID of the RBAC Group.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # RFC 3339 timestamp of when the RBAC Group was created.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Name of the RBAC Group. Not uniqueness-enforced.
+        sig { returns(String) }
+        attr_accessor :name
+
+        # RBAC Role IDs attached to this RBAC Group. Role attachment is managed in the
+        # admin settings and is read-only on this API. `null` means role data was
+        # temporarily unavailable — retry to distinguish from an empty list.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :role_ids
+
+        # How the RBAC Group was created: `"direct"` for groups created directly (for
+        # example, in the organization's admin settings), `"scim"` for groups provisioned
+        # by the identity provider.
+        sig do
+          returns(Anthropic::Organization::RBACGroup::SourceType::TaggedSymbol)
+        end
+        attr_accessor :source_type
+
+        # Object type.
+        #
+        # For RBAC Groups, this is always `"rbac_group"`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # RFC 3339 timestamp of when the RBAC Group was last updated.
+        sig { returns(Time) }
+        attr_accessor :updated_at
+
+        sig do
+          params(
+            id: String,
+            created_at: Time,
+            name: String,
+            role_ids: T.nilable(T::Array[String]),
+            source_type:
+              Anthropic::Organization::RBACGroup::SourceType::OrSymbol,
+            updated_at: Time,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # ID of the RBAC Group.
+          id:,
+          # RFC 3339 timestamp of when the RBAC Group was created.
+          created_at:,
+          # Name of the RBAC Group. Not uniqueness-enforced.
+          name:,
+          # RBAC Role IDs attached to this RBAC Group. Role attachment is managed in the
+          # admin settings and is read-only on this API. `null` means role data was
+          # temporarily unavailable — retry to distinguish from an empty list.
+          role_ids:,
+          # How the RBAC Group was created: `"direct"` for groups created directly (for
+          # example, in the organization's admin settings), `"scim"` for groups provisioned
+          # by the identity provider.
+          source_type:,
+          # RFC 3339 timestamp of when the RBAC Group was last updated.
+          updated_at:,
+          # Object type.
+          #
+          # For RBAC Groups, this is always `"rbac_group"`.
+          type: :rbac_group
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              name: String,
+              role_ids: T.nilable(T::Array[String]),
+              source_type:
+                Anthropic::Organization::RBACGroup::SourceType::TaggedSymbol,
+              type: Symbol,
+              updated_at: Time
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # How the RBAC Group was created: `"direct"` for groups created directly (for
+        # example, in the organization's admin settings), `"scim"` for groups provisioned
+        # by the identity provider.
+        module SourceType
+          extend Anthropic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Anthropic::Organization::RBACGroup::SourceType)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          DIRECT =
+            T.let(
+              :direct,
+              Anthropic::Organization::RBACGroup::SourceType::TaggedSymbol
+            )
+          SCIM =
+            T.let(
+              :scim,
+              Anthropic::Organization::RBACGroup::SourceType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Anthropic::Organization::RBACGroup::SourceType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end