openai 0.103.0 → 0.104.0

data/lib/openai/models/admin/organization/oci_external_storage_provider.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        class OciExternalStorageProvider < OpenAI::Internal::Type::BaseModel
+          # @!attribute bucket
+          #
+          #   @return [String]
+          required :bucket, String
+
+          # @!attribute region
+          #
+          #   @return [String]
+          required :region, String
+
+          # @!attribute tenancy_ocid
+          #
+          #   @return [String]
+          required :tenancy_ocid, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :oci]
+          required :type, const: :oci
+
+          # @!method initialize(bucket:, region:, tenancy_ocid:, type: :oci)
+          #   @param bucket [String]
+          #   @param region [String]
+          #   @param tenancy_ocid [String]
+          #   @param type [Symbol, :oci]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/project_residency.rb

@@ -11,11 +11,14 @@ module OpenAI
           US_STORAGE_PROCESSING = :US_STORAGE_PROCESSING
           EU_STORAGE_PROCESSING = :EU_STORAGE_PROCESSING
           JP_STORAGE = :JP_STORAGE
+          JP_STORAGE_PROCESSING = :JP_STORAGE_PROCESSING
           KR_STORAGE = :KR_STORAGE
           CA_STORAGE = :CA_STORAGE
           SG_STORAGE = :SG_STORAGE
           IN_STORAGE = :IN_STORAGE
+          IN_STORAGE_PROCESSING = :IN_STORAGE_PROCESSING
           AU_STORAGE = :AU_STORAGE
+          AU_STORAGE_PROCESSING = :AU_STORAGE_PROCESSING
           GB_STORAGE = :GB_STORAGE
           AE_STORAGE = :AE_STORAGE
           AE_STORAGE_PROCESSING = :AE_STORAGE_PROCESSING

data/lib/openai/models/admin/organization/projects/api_key_update_params.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module Projects
+          # @see OpenAI::Resources::Admin::Organization::Projects::APIKeys#update
+          class APIKeyUpdateParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute project_id
+            #
+            #   @return [String]
+            required :project_id, String
+
+            # @!attribute api_key_id
+            #
+            #   @return [String]
+            required :api_key_id, String
+
+            # @!attribute expires_in_seconds
+            #   Number of seconds from this request until the API key expires. Must comply with
+            #   the organization and project expiry policies. Expired keys cannot be updated.
+            #   Retrying resets the expiry relative to the new request. Omit to keep the current
+            #   expiration.
+            #
+            #   @return [Integer, nil]
+            optional :expires_in_seconds, Integer
+
+            # @!attribute scopes
+            #   Replace the API key scope restrictions. Omit to leave scopes unchanged. An empty
+            #   array removes key restrictions (All permissions), subject to the owner's
+            #   effective permissions. Use ["api.all.read"] for read-only access. Scopes do not
+            #   change the owner's roles or grant administrative permissions.
+            #
+            #   @return [Array<String>, nil]
+            optional :scopes, OpenAI::Internal::Type::ArrayOf[String]
+
+            # @!method initialize(project_id:, api_key_id:, expires_in_seconds: nil, scopes: nil, request_options: {})
+            #   @param project_id [String]
+            #
+            #   @param api_key_id [String]
+            #
+            #   @param expires_in_seconds [Integer]
+            #     Number of seconds from this request until the API key expires. Must comply with
+            #     the organization and project expiry policies. Expired keys cannot be updated.
+            #     Retrying resets the expiry relative to the new request. Omit to keep the current
+            #     expiration.
+            #
+            #   @param scopes [Array<String>]
+            #     Replace the API key scope restrictions. Omit to leave scopes unchanged. An empty
+            #     array removes key restrictions (All permissions), subject to the owner's
+            #     effective permissions. Use ["api.all.read"] for read-only access. Scopes do not
+            #     change the owner's roles or grant administrative permissions.
+            #
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/projects/api_key_update_scopes_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module Projects
+          # @see OpenAI::Resources::Admin::Organization::Projects::APIKeys#update_scopes
+          class APIKeyUpdateScopesParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute project_id
+            #
+            #   @return [String]
+            required :project_id, String
+
+            # @!attribute scopes
+            #
+            #   @return [Array<String>]
+            required :scopes, OpenAI::Internal::Type::ArrayOf[String]
+
+            # @!method initialize(project_id:, scopes:, request_options: {})
+            #   @param project_id [String]
+            #
+            #   @param scopes [Array<String>]
+            #
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/usage_decisions_params.rb

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::Usage#decisions
+        class UsageDecisionsParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute start_time
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          #   @return [Integer]
+          required :start_time, Integer
+
+          # @!attribute api_key_ids
+          #   Return only usage for these API keys.
+          #
+          #   @return [Array<String>, nil]
+          optional :api_key_ids, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!attribute batch
+          #   If `true`, return batch jobs only. If `false`, return non-batch jobs only. By
+          #   default, return both.
+          #
+          #   @return [Boolean, nil]
+          optional :batch, OpenAI::Internal::Type::Boolean, nil?: true
+
+          # @!attribute bucket_width
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
+          #
+          #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsParams::BucketWidth, nil]
+          optional(
+            :bucket_width,
+            enum: -> { OpenAI::Admin::Organization::UsageDecisionsParams::BucketWidth },
+            nil?: true
+          )
+
+          # @!attribute end_time
+          #   End time (Unix seconds) of the query time range, exclusive.
+          #
+          #   @return [Integer, nil]
+          optional :end_time, Integer, nil?: true
+
+          # @!attribute group_by
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`,
+          #   `api_source` or any combination of them. When grouped by `api_source`, results
+          #   use `agents_api` for attributed Agents API activity and `unlabeled` for all
+          #   other activity. Without source grouping, `api_source` is null.
+          #
+          #   @return [Array<Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsParams::GroupBy>, nil]
+          optional(
+            :group_by,
+            -> {
+              OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Admin::Organization::UsageDecisionsParams::GroupBy]
+            },
+            nil?: true
+          )
+
+          # @!attribute limit
+          #   Specifies the number of buckets to return.
+          #
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
+          #
+          #   @return [Integer, nil]
+          optional :limit, Integer, nil?: true
+
+          # @!attribute models
+          #   Return only usage for these models.
+          #
+          #   @return [Array<String>, nil]
+          optional :models, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!attribute page
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
+          #
+          #   @return [String, nil]
+          optional :page, String, nil?: true
+
+          # @!attribute project_ids
+          #   Return only usage for these projects.
+          #
+          #   @return [Array<String>, nil]
+          optional :project_ids, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!attribute user_ids
+          #   Return only usage for these users.
+          #
+          #   @return [Array<String>, nil]
+          optional :user_ids, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!method initialize(start_time:, api_key_ids: nil, batch: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
+          #   @param start_time [Integer]
+          #     Start time (Unix seconds) of the query time range, inclusive.
+          #
+          #   @param api_key_ids [Array<String>, nil]
+          #     Return only usage for these API keys.
+          #
+          #   @param batch [Boolean, nil]
+          #     If `true`, return batch jobs only. If `false`, return non-batch jobs only. By
+          #     default, return both.
+          #
+          #   @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsParams::BucketWidth, nil]
+          #     Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #     supported, default to `1d`.
+          #
+          #   @param end_time [Integer, nil]
+          #     End time (Unix seconds) of the query time range, exclusive.
+          #
+          #   @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsParams::GroupBy>, nil]
+          #     Group the usage data by the specified fields. Support fields include
+          #     `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`,
+          #     `api_source` or any combination of them. When grouped by `api_source`, results
+          #     use `agents_api` for attributed Agents API activity and `unlabeled` for all
+          #     other activity. Without source grouping, `api_source` is null.
+          #
+          #   @param limit [Integer, nil]
+          #     Specifies the number of buckets to return.
+          #
+          #     - `bucket_width=1d`: default: 7, max: 31
+          #     - `bucket_width=1h`: default: 24, max: 168
+          #     - `bucket_width=1m`: default: 60, max: 1440
+          #
+          #   @param models [Array<String>, nil]
+          #     Return only usage for these models.
+          #
+          #   @param page [String, nil]
+          #     A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #     previous response.
+          #
+          #   @param project_ids [Array<String>, nil]
+          #     Return only usage for these projects.
+          #
+          #   @param user_ids [Array<String>, nil]
+          #     Return only usage for these users.
+          #
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+          # Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          # supported, default to `1d`.
+          module BucketWidth
+            extend OpenAI::Internal::Type::Enum
+
+            BUCKET_WIDTH_1M = :"1m"
+            BUCKET_WIDTH_1H = :"1h"
+            BUCKET_WIDTH_1D = :"1d"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          module GroupBy
+            extend OpenAI::Internal::Type::Enum
+
+            PROJECT_ID = :project_id
+            USER_ID = :user_id
+            API_KEY_ID = :api_key_id
+            MODEL = :model
+            BATCH = :batch
+            SERVICE_TIER = :service_tier
+            API_SOURCE = :api_source
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/usage_decisions_response.rb

@@ -0,0 +1,351 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::Usage#decisions
+        class UsageDecisionsResponse < OpenAI::Internal::Type::BaseModel
+          # @!attribute data
+          #
+          #   @return [Array<OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data>]
+          required(
+            :data,
+            -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data] }
+          )
+
+          # @!attribute has_more
+          #
+          #   @return [Boolean]
+          required :has_more, OpenAI::Internal::Type::Boolean
+
+          # @!attribute next_page
+          #
+          #   @return [String, nil]
+          required :next_page, String, nil?: true
+
+          # @!attribute object
+          #
+          #   @return [Symbol, :page]
+          required :object, const: :page
+
+          # @!method initialize(data:, has_more:, next_page:, object: :page)
+          #   @param data [Array<OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data>]
+          #   @param has_more [Boolean]
+          #   @param next_page [String, nil]
+          #   @param object [Symbol, :page]
+
+          class Data < OpenAI::Internal::Type::BaseModel
+            # @!attribute end_time
+            #
+            #   @return [Integer]
+            required :end_time, Integer
+
+            # @!attribute object
+            #
+            #   @return [Symbol, :bucket]
+            required :object, const: :bucket
+
+            # @!attribute results
+            #
+            #   @return [Array<OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data::Result>]
+            required(
+              :results,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[
+                  OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data::Result
+                ]
+              }
+            )
+
+            # @!attribute start_time
+            #
+            #   @return [Integer]
+            required :start_time, Integer
+
+            # @!method initialize(end_time:, results:, start_time:, object: :bucket)
+            #   @param end_time [Integer]
+            #   @param results [Array<OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data::Result>]
+            #   @param start_time [Integer]
+            #   @param object [Symbol, :bucket]
+
+            class Result < OpenAI::Internal::Type::BaseModel
+              # @!attribute input_tokens
+              #   The aggregated number of input tokens used, including cached and cache-write
+              #   tokens. This includes text, audio, and image tokens. For customers subscribed to
+              #   Scale Tier, this includes Scale Tier tokens.
+              #
+              #   @return [Integer]
+              required :input_tokens, Integer
+
+              # @!attribute num_model_requests
+              #   The count of requests made to the model.
+              #
+              #   @return [Integer]
+              required :num_model_requests, Integer
+
+              # @!attribute object
+              #
+              #   @return [Symbol, :"organization.usage.decisions.result"]
+              required :object, const: :"organization.usage.decisions.result"
+
+              # @!attribute output_tokens
+              #   The aggregated number of output tokens used across text, audio, and image
+              #   outputs. For customers subscribed to Scale Tier, this includes Scale Tier
+              #   tokens.
+              #
+              #   @return [Integer]
+              required :output_tokens, Integer
+
+              # @!attribute api_key_id
+              #   When `group_by=api_key_id`, this field provides the API key ID of the grouped
+              #   usage result.
+              #
+              #   @return [String, nil]
+              optional :api_key_id, String, nil?: true
+
+              # @!attribute api_source
+              #   When grouped by `api_source`, `agents_api` identifies attributed Agents API
+              #   activity and `unlabeled` includes all records without published source
+              #   attribution, including historical and unknown origins. Unlabeled does not imply
+              #   direct API usage. Without source grouping, this field is null.
+              #
+              #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data::Result::APISource, nil]
+              optional(
+                :api_source,
+                enum: -> { OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data::Result::APISource },
+                nil?: true
+              )
+
+              # @!attribute batch
+              #   When `group_by=batch`, this field tells whether the grouped usage result is
+              #   batch or not.
+              #
+              #   @return [Boolean, nil]
+              optional :batch, OpenAI::Internal::Type::Boolean, nil?: true
+
+              # @!attribute input_audio_tokens
+              #   The aggregated number of uncached audio input tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :input_audio_tokens, Integer, nil?: true
+
+              # @!attribute input_cache_write_12h_tokens
+              #   The aggregated number of input tokens written to the cache with a 12-hour
+              #   retention period.
+              #
+              #   @return [Integer, nil]
+              optional :input_cache_write_12h_tokens, Integer, nil?: true
+
+              # @!attribute input_cache_write_tokens
+              #   The aggregated number of input tokens written to the cache with a 30-minute
+              #   retention period.
+              #
+              #   @return [Integer, nil]
+              optional :input_cache_write_tokens, Integer, nil?: true
+
+              # @!attribute input_cached_audio_tokens
+              #   The aggregated number of cached audio input tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :input_cached_audio_tokens, Integer, nil?: true
+
+              # @!attribute input_cached_image_tokens
+              #   The aggregated number of cached image input tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :input_cached_image_tokens, Integer, nil?: true
+
+              # @!attribute input_cached_text_tokens
+              #   The aggregated number of cached text input tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :input_cached_text_tokens, Integer, nil?: true
+
+              # @!attribute input_cached_tokens
+              #   The aggregated number of cached input tokens used across text, audio, and image
+              #   inputs. For customers subscribed to Scale Tier, this includes Scale Tier tokens.
+              #
+              #   @return [Integer, nil]
+              optional :input_cached_tokens, Integer, nil?: true
+
+              # @!attribute input_image_tokens
+              #   The aggregated number of uncached image input tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :input_image_tokens, Integer, nil?: true
+
+              # @!attribute input_text_tokens
+              #   The aggregated number of uncached text input tokens used, excluding cache-write
+              #   tokens.
+              #
+              #   @return [Integer, nil]
+              optional :input_text_tokens, Integer, nil?: true
+
+              # @!attribute input_uncached_tokens
+              #   The aggregated number of uncached input tokens used across text, audio, and
+              #   image inputs, excluding cache-write tokens.
+              #
+              #   @return [Integer, nil]
+              optional :input_uncached_tokens, Integer, nil?: true
+
+              # @!attribute model
+              #   When `group_by=model`, this field provides the model name of the grouped usage
+              #   result.
+              #
+              #   @return [String, nil]
+              optional :model, String, nil?: true
+
+              # @!attribute output_audio_tokens
+              #   The aggregated number of audio output tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :output_audio_tokens, Integer, nil?: true
+
+              # @!attribute output_image_tokens
+              #   The aggregated number of image output tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :output_image_tokens, Integer, nil?: true
+
+              # @!attribute output_text_tokens
+              #   The aggregated number of text output tokens used.
+              #
+              #   @return [Integer, nil]
+              optional :output_text_tokens, Integer, nil?: true
+
+              # @!attribute project_id
+              #   When `group_by=project_id`, this field provides the project ID of the grouped
+              #   usage result.
+              #
+              #   @return [String, nil]
+              optional :project_id, String, nil?: true
+
+              # @!attribute service_tier
+              #   When `group_by=service_tier`, this field provides the service tier of the
+              #   grouped usage result.
+              #
+              #   @return [String, nil]
+              optional :service_tier, String, nil?: true
+
+              # @!attribute user_id
+              #   When `group_by=user_id`, this field provides the user ID of the grouped usage
+              #   result.
+              #
+              #   @return [String, nil]
+              optional :user_id, String, nil?: true
+
+              # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.decisions.result")
+              #   The aggregated Decisions API usage details of the specific time bucket.
+              #
+              #   @param input_tokens [Integer]
+              #     The aggregated number of input tokens used, including cached and cache-write
+              #     tokens. This includes text, audio, and image tokens. For customers subscribed to
+              #     Scale Tier, this includes Scale Tier tokens.
+              #
+              #   @param num_model_requests [Integer]
+              #     The count of requests made to the model.
+              #
+              #   @param output_tokens [Integer]
+              #     The aggregated number of output tokens used across text, audio, and image
+              #     outputs. For customers subscribed to Scale Tier, this includes Scale Tier
+              #     tokens.
+              #
+              #   @param api_key_id [String, nil]
+              #     When `group_by=api_key_id`, this field provides the API key ID of the grouped
+              #     usage result.
+              #
+              #   @param api_source [Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data::Result::APISource, nil]
+              #     When grouped by `api_source`, `agents_api` identifies attributed Agents API
+              #     activity and `unlabeled` includes all records without published source
+              #     attribution, including historical and unknown origins. Unlabeled does not imply
+              #     direct API usage. Without source grouping, this field is null.
+              #
+              #   @param batch [Boolean, nil]
+              #     When `group_by=batch`, this field tells whether the grouped usage result is
+              #     batch or not.
+              #
+              #   @param input_audio_tokens [Integer, nil]
+              #     The aggregated number of uncached audio input tokens used.
+              #
+              #   @param input_cache_write_12h_tokens [Integer, nil]
+              #     The aggregated number of input tokens written to the cache with a 12-hour
+              #     retention period.
+              #
+              #   @param input_cache_write_tokens [Integer, nil]
+              #     The aggregated number of input tokens written to the cache with a 30-minute
+              #     retention period.
+              #
+              #   @param input_cached_audio_tokens [Integer, nil]
+              #     The aggregated number of cached audio input tokens used.
+              #
+              #   @param input_cached_image_tokens [Integer, nil]
+              #     The aggregated number of cached image input tokens used.
+              #
+              #   @param input_cached_text_tokens [Integer, nil]
+              #     The aggregated number of cached text input tokens used.
+              #
+              #   @param input_cached_tokens [Integer, nil]
+              #     The aggregated number of cached input tokens used across text, audio, and image
+              #     inputs. For customers subscribed to Scale Tier, this includes Scale Tier tokens.
+              #
+              #   @param input_image_tokens [Integer, nil]
+              #     The aggregated number of uncached image input tokens used.
+              #
+              #   @param input_text_tokens [Integer, nil]
+              #     The aggregated number of uncached text input tokens used, excluding cache-write
+              #     tokens.
+              #
+              #   @param input_uncached_tokens [Integer, nil]
+              #     The aggregated number of uncached input tokens used across text, audio, and
+              #     image inputs, excluding cache-write tokens.
+              #
+              #   @param model [String, nil]
+              #     When `group_by=model`, this field provides the model name of the grouped usage
+              #     result.
+              #
+              #   @param output_audio_tokens [Integer, nil]
+              #     The aggregated number of audio output tokens used.
+              #
+              #   @param output_image_tokens [Integer, nil]
+              #     The aggregated number of image output tokens used.
+              #
+              #   @param output_text_tokens [Integer, nil]
+              #     The aggregated number of text output tokens used.
+              #
+              #   @param project_id [String, nil]
+              #     When `group_by=project_id`, this field provides the project ID of the grouped
+              #     usage result.
+              #
+              #   @param service_tier [String, nil]
+              #     When `group_by=service_tier`, this field provides the service tier of the
+              #     grouped usage result.
+              #
+              #   @param user_id [String, nil]
+              #     When `group_by=user_id`, this field provides the user ID of the grouped usage
+              #     result.
+              #
+              #   @param object [Symbol, :"organization.usage.decisions.result"]
+
+              # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+              # activity and `unlabeled` includes all records without published source
+              # attribution, including historical and unknown origins. Unlabeled does not imply
+              # direct API usage. Without source grouping, this field is null.
+              #
+              # @see OpenAI::Models::Admin::Organization::UsageDecisionsResponse::Data::Result#api_source
+              module APISource
+                extend OpenAI::Internal::Type::Enum
+
+                AGENTS_API = :agents_api
+                UNLABELED = :unlabeled
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end