openai 0.102.0 → 0.104.0

data/rbi/openai/resources/admin/organization/projects/api_keys.rbi

@@ -26,6 +26,54 @@ module OpenAI
             )
             end
 
+            # Updates the scopes and/or expiration of an existing API key in the project,
+            # including a service-account-owned key. Requires permission to write project API
+            # keys.
+            #
+            # Provide at least one of `scopes` or `expires_in_seconds`. Omitted fields stay
+            # unchanged; neither field accepts `null`. Both changes are saved together.
+            #
+            # `scopes` replaces the key's scope restrictions using the same scope identifiers
+            # as the dashboard. An empty array means All permissions, subject to the owner's
+            # effective access; it does not mean no access. Use `["api.all.read"]` for
+            # read-only access or specific scopes such as `["api.files.read"]` for restricted
+            # access. This does not change user or service-account roles or grant admin
+            # permissions. Scope changes follow the same authentication-cache propagation as
+            # dashboard edits.
+            #
+            # Provide `expires_in_seconds` to set the expiration relative to this request. The
+            # value must satisfy the organization's and project's expiry policies. Expired
+            # keys cannot be updated. Retrying resets the expiration relative to the new
+            # request. The response contains only the redacted key, not its secret.
+            sig {
+              params(
+                api_key_id: String,
+                project_id: String,
+                expires_in_seconds: Integer,
+                scopes: T::Array[String],
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Admin::Organization::Projects::ProjectAPIKey)
+            }
+            def update(
+              # Path param: The ID of the API key.
+              api_key_id,
+              # Path param: The ID of the project.
+              project_id:,
+              # Body param: 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.
+              expires_in_seconds: nil,
+              # Body param: 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.
+              scopes: nil,
+              request_options: {}
+            )
+            end
+
             # Returns a list of API keys in the project.
             sig {
               params(

data/rbi/openai/resources/admin/organization/usage.rbi

@@ -252,6 +252,62 @@ module OpenAI
           )
           end
 
+          # Get Decisions API usage details for the organization.
+          sig {
+            params(
+              start_time: Integer,
+              api_key_ids: T.nilable(T::Array[String]),
+              batch: T.nilable(T::Boolean),
+              bucket_width: T.nilable(OpenAI::Admin::Organization::UsageDecisionsParams::BucketWidth::OrSymbol),
+              end_time: T.nilable(Integer),
+              group_by: T.nilable(T::Array[OpenAI::Admin::Organization::UsageDecisionsParams::GroupBy::OrSymbol]),
+              limit: T.nilable(Integer),
+              models: T.nilable(T::Array[String]),
+              page: T.nilable(String),
+              project_ids: T.nilable(T::Array[String]),
+              user_ids: T.nilable(T::Array[String]),
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Models::Admin::Organization::UsageDecisionsResponse)
+          }
+          def decisions(
+            # Start time (Unix seconds) of the query time range, inclusive.
+            start_time:,
+            # Return only usage for these API keys.
+            api_key_ids: nil,
+            # If `true`, return batch jobs only. If `false`, return non-batch jobs only. By
+            # default, return both.
+            batch: nil,
+            # Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+            # supported, default to `1d`.
+            bucket_width: nil,
+            # End time (Unix seconds) of the query time range, exclusive.
+            end_time: 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.
+            group_by: 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
+            limit: nil,
+            # Return only usage for these models.
+            models: nil,
+            # A cursor for use in pagination. Corresponding to the `next_page` field from the
+            # previous response.
+            page: nil,
+            # Return only usage for these projects.
+            project_ids: nil,
+            # Return only usage for these users.
+            user_ids: nil,
+            request_options: {}
+          )
+          end
+
           # Get embeddings usage details for the organization.
           sig {
             params(

data/rbi/openai/resources/audio/speech.rbi

@@ -41,7 +41,8 @@ module OpenAI
           # object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
           # voices are available in the
           # [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
-          # Custom voices must be created from audio samples.
+          # Custom voices must be created from audio samples. Voices created from text
+          # prompts are supported only in Live.
           voice:,
           # Control the voice of your generated audio with additional instructions. Does not
           # work with `tts-1` or `tts-1-hd`.

data/rbi/openai/resources/audio/voices.rbi

@@ -8,20 +8,23 @@ module OpenAI
       # Turn audio into text or text into audio.
       class Voices
 
-        # Create a custom voice you can use for audio output (for example, in
-        # Text-to-Speech and the Realtime API). This requires an audio sample and a
-        # previously uploaded consent recording.
+        # Creates a voice from a text prompt or from a consent recording and an audio
+        # sample.
         #
-        # Send `name`, `audio_sample`, and the `consent` recording ID as multipart form
-        # data. The optional `type` defaults to `audio_sample`.
+        # For prompt-based creation, send `type: "prompt"` with a `name` and `prompt` as
+        # JSON or multipart form data. For creation from an audio sample, send
+        # `type: "audio_sample"` with a `name`, `audio_sample`, and `consent` recording ID
+        # as multipart form data. The type defaults to `audio_sample` when omitted.
         #
-        # Returns the saved voice's metadata. See the
-        # [custom voices guide](https://developers.openai.com/api/docs/guides/text-to-speech#custom-voices)
-        # for requirements and best practices. Custom voices are limited to eligible
-        # customers.
+        # Returns the saved voice's metadata. Voices created from text prompts are
+        # supported only in Live, not in Realtime or the speech endpoint. The response
+        # does not include preview audio.
         sig {
           params(
-            body: OpenAI::Audio::VoiceCreateParams::Body::AudioSample::OrHash,
+            body: T.any(
+              OpenAI::Audio::VoiceCreateParams::Body::AudioSample::OrHash,
+              OpenAI::Audio::VoiceCreateParams::Body::Prompt::OrHash
+            ),
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Audio::Voice)

data/rbi/openai/resources/beta/agents/environments/files.rbi

@@ -10,40 +10,10 @@ module OpenAI
         class Environments
 
           class Files
-            # Beta file helpers.
-            sig {
-              params(files: T::Hash[String, T.any(String, Pathname)], request_options: OpenAI::RequestOptions::OrHash)
-                .returns(OpenAI::Helpers::Beta::Agents::PreparedFiles)
-            }
-            def prepare(files, request_options: {})
-            end
-
-            sig {
-              params(
-                directory: T.any(String, Pathname),
-                destination: String,
-                include: T::Array[String],
-                request_options: OpenAI::RequestOptions::OrHash
-              )
-                .returns(OpenAI::Helpers::Beta::Agents::PreparedFiles)
-            }
-            def prepare_directory(directory, destination:, include:, request_options: {})
-            end
-
-            sig {
-              params(
-                environment_id: String,
-                file: T.any(String, Pathname),
-                path: String,
-                request_options: OpenAI::RequestOptions::OrHash
-              )
-                .returns(OpenAI::Helpers::Beta::Agents::PreparedFiles)
-            }
-            def upload(environment_id, file:, path:, request_options: {})
-            end
 
-            # Copies inline bytes or a Files API file into a connected execution environment.
-            # See
+            # Copies inline bytes or a Files API file into a connected execution environment,
+            # replacing an existing regular file at the same path. Upload between turns and
+            # wait for success before starting the next turn. See
             # [environment files](https://developers.openai.com/api/docs/guides/agents-api/environments/files).
             sig {
               params(

data/rbi/openai/resources/beta/agents/environments.rbi

@@ -71,11 +71,11 @@ module OpenAI
               .returns(OpenAI::Internal::CursorPage[OpenAI::Beta::Agents::EnvironmentInfo])
           }
           def list(
-            # Return environments after this environment ID in the selected order.
+            # Return resources after this resource ID in the selected order.
             after: nil,
-            # The maximum number of environments to return, between 1 and 100. Defaults to 20.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
-            # The order in which environments are returned. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
             # The hosting type to list. Defaults to `openai_hosted`.
             type: nil,

data/rbi/openai/resources/beta/agents/sessions/artifacts.rbi

@@ -10,14 +10,6 @@ module OpenAI
         class Sessions
 
           class Artifacts
-            # Beta result-scoped downloads.
-            sig {
-              params(result: OpenAI::Helpers::Beta::Agents::TurnResult).returns(
-                OpenAI::Helpers::Beta::Agents::ResultArtifacts
-              )
-            }
-            def for_result(result)
-            end
 
             # Retrieves immutable metadata for one durable session artifact. See
             # [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
@@ -40,9 +32,9 @@ module OpenAI
             sig {
               params(
                 session_id: String,
-                after: T.nilable(String),
+                after: String,
                 environment_id: T.nilable(String),
-                limit: T.nilable(Integer),
+                limit: Integer,
                 order: OpenAI::Beta::Agents::Sessions::ArtifactListParams::Order::OrSymbol,
                 request_options: OpenAI::RequestOptions::OrHash
               )
@@ -51,13 +43,13 @@ module OpenAI
             def list(
               # The ID of the session.
               session_id,
-              # Return artifacts after this immutable artifact ID.
+              # Return resources after this resource ID in the selected order.
               after: nil,
               # Restrict the listing to artifacts produced by this environment.
               environment_id: nil,
-              # The maximum number of artifacts to return, between 1 and 100.
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
               limit: nil,
-              # Sort by creation time and ID. Defaults to descending.
+              # The order in which resources are returned. Defaults to `desc`.
               order: nil,
               request_options: {}
             )

data/rbi/openai/resources/beta/agents/sessions.rbi

@@ -44,6 +44,7 @@ module OpenAI
               agent_id: String,
               input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
               vault_ids: T.nilable(T::Array[String]),
               stream: T.noreturn,
               request_options: OpenAI::RequestOptions::OrHash
@@ -67,6 +68,9 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            spend_control: nil,
             # The IDs of vaults made available to the session.
             vault_ids: nil,
             # There is no need to provide `stream:`. Instead, use `#create_streaming` or
@@ -95,6 +99,7 @@ module OpenAI
               output_type: T.nilable(T.class_of(OpenAI::Helpers::StructuredOutput::BaseModel)),
               input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
               vault_ids: T.nilable(T::Array[String]),
               stream: T.noreturn,
               request_options: OpenAI::RequestOptions::OrHash
@@ -120,6 +125,9 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            spend_control: nil,
             # The IDs of vaults made available to the session.
             vault_ids: nil,
             # There is no need to provide `stream:`. Instead, use `#create_streaming` or
@@ -151,6 +159,7 @@ module OpenAI
               session_id: String,
               agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent::OrHash,
               metadata: T.nilable(T::Hash[Symbol, String]),
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash),
               request_options: OpenAI::RequestOptions::OrHash
             )
               .returns(OpenAI::Beta::AgentSession)
@@ -164,6 +173,9 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters.
             metadata: nil,
+            # Omit to retain the limit; null or a null limit removes it without resetting
+            # spend.
+            spend_control: nil,
             request_options: {}
           )
           end
@@ -175,7 +187,7 @@ module OpenAI
             params(
               after: String,
               agent_id: String,
-              limit: T.nilable(Integer),
+              limit: Integer,
               order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
               request_options: OpenAI::RequestOptions::OrHash
             )
@@ -187,10 +199,9 @@ module OpenAI
             # Only return sessions whose root agent has this ID. Omit to return sessions for
             # all agents.
             agent_id: nil,
-            # The maximum number of resources to return.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
             request_options: {}
           )

data/rbi/openai/resources/beta/agents/vaults/credentials.rbi

@@ -98,7 +98,8 @@ module OpenAI
               params(
                 vault_id: String,
                 after: String,
-                limit: T.nilable(Integer),
+                limit: Integer,
+                metadata: T::Hash[Symbol, String],
                 order: OpenAI::Beta::Agents::Vaults::CredentialListParams::Order::OrSymbol,
                 status: T.any(
                   OpenAI::Beta::Agents::VaultStatus::OrSymbol,
@@ -113,11 +114,14 @@ module OpenAI
               vault_id,
               # Return resources after this resource ID in the selected order.
               after: nil,
-              # The maximum number of resources to return. Defaults to 20. Values are clamped
-              # between 1 and 100.
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
               limit: nil,
-              # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-              # `desc` for descending order. Defaults to `desc`.
+              # Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+              # match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+              # characters. Filtering is eventually consistent; metadata changes may take time
+              # to appear.
+              metadata: nil,
+              # The order in which resources are returned. Defaults to `desc`.
               order: nil,
               # Filter by one status or a list, such as `status=active` or
               # `status[]=active&status[]=archived`. Both statuses are included by default.

data/rbi/openai/resources/beta/agents/vaults.rbi

@@ -47,12 +47,38 @@ module OpenAI
           )
           end
 
+          # Updates the name or metadata of an active vault. Omitted fields remain
+          # unchanged. See
+          # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+          sig {
+            params(
+              vault_id: String,
+              metadata: T::Hash[Symbol, String],
+              name: T.nilable(String),
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Beta::Agents::Vault)
+          }
+          def update(
+            # The ID of the vault.
+            vault_id,
+            # Replaces all metadata. Omit to leave unchanged, or pass {} to clear it. Up to 16
+            # string key-value pairs, with keys up to 64 and values up to 512 characters.
+            metadata: nil,
+            # A replacement name. Omit to leave unchanged, or pass null to clear it. The name
+            # is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.
+            name: nil,
+            request_options: {}
+          )
+          end
+
           # Lists vaults using ID-based pagination. See
           # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
           sig {
             params(
               after: String,
-              limit: T.nilable(Integer),
+              limit: Integer,
+              metadata: T::Hash[Symbol, String],
               order: OpenAI::Beta::Agents::VaultListParams::Order::OrSymbol,
               status: T.any(
                 OpenAI::Beta::Agents::VaultStatus::OrSymbol,
@@ -65,11 +91,14 @@ module OpenAI
           def list(
             # Return resources after this resource ID in the selected order.
             after: nil,
-            # The maximum number of resources to return. Defaults to 20. Values are clamped
-            # between 1 and 100.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+            # match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+            # characters. Filtering is eventually consistent; metadata changes may take time
+            # to appear.
+            metadata: nil,
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
             # Filter by one status or a list, such as `status=active` or
             # `status[]=active&status[]=archived`. Both statuses are included by default.

data/rbi/openai/resources/beta/agents.rbi

@@ -65,7 +65,8 @@ module OpenAI
           # Configuration for generated text. Defaults to the `text` format and medium
           # verbosity.
           text: nil,
-          # Tools available to the agent. Defaults to an empty list.
+          # Tools available to the agent. Defaults to an empty list. The tool list must fit
+          # within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
           tools: nil,
           request_options: {}
         )
@@ -133,7 +134,8 @@ module OpenAI
           service_tier: nil,
           # Configuration for text generated by the agent.
           text: nil,
-          # Tools available to the agent.
+          # Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
+          # The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
           tools: nil,
           request_options: {}
         )
@@ -144,7 +146,7 @@ module OpenAI
         sig {
           params(
             after: String,
-            limit: T.nilable(Integer),
+            limit: Integer,
             order: OpenAI::Beta::AgentListParams::Order::OrSymbol,
             request_options: OpenAI::RequestOptions::OrHash
           )
@@ -153,7 +155,7 @@ module OpenAI
         def list(
           # Return resources after this resource ID in the selected order.
           after: nil,
-          # The maximum number of resources to return.
+          # The maximum number of resources to return, between 1 and 100. Defaults to 20.
           limit: nil,
           # The order in which resources are returned. Defaults to `desc`.
           order: nil,

data/rbi/openai/resources/beta/responses.rbi

@@ -222,7 +222,7 @@ module OpenAI
           reasoning: nil,
           # Body param: A stable identifier used to help detect users of your application
           # that may be violating OpenAI's usage policies. The IDs should be a string that
-          # uniquely identifies each user, with a maximum length of 64 characters. We
+          # uniquely identifies each user, with a maximum length of 128 characters. We
           # recommend hashing their username or email address, in order to avoid sending us
           # any identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -544,7 +544,7 @@ module OpenAI
           reasoning: nil,
           # Body param: A stable identifier used to help detect users of your application
           # that may be violating OpenAI's usage policies. The IDs should be a string that
-          # uniquely identifies each user, with a maximum length of 64 characters. We
+          # uniquely identifies each user, with a maximum length of 128 characters. We
           # recommend hashing their username or email address, in order to avoid sending us
           # any identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).

data/rbi/openai/resources/chat/completions.rbi

@@ -36,7 +36,7 @@ module OpenAI
         #
         # Returns a chat completion object, or a streamed sequence of chat completion
         # chunk objects if the request is streamed.
-        sig do
+        sig {
           params(
             messages: T::Array[
               T.any(
@@ -72,10 +72,12 @@ module OpenAI
             prompt_cache_retention: T.nilable(OpenAI::Chat::CompletionCreateParams::PromptCacheRetention::OrSymbol),
             reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
             response_format: T.any(
-              OpenAI::ResponseFormatText::OrHash,
-              OpenAI::ResponseFormatJSONSchema::OrHash,
-              OpenAI::StructuredOutput::JsonSchemaConverter,
-              OpenAI::ResponseFormatJSONObject::OrHash
+              T.any(
+                OpenAI::ResponseFormatText::OrHash,
+                OpenAI::ResponseFormatJSONSchema::OrHash,
+                OpenAI::ResponseFormatJSONObject::OrHash
+              ),
+              OpenAI::StructuredOutput::JsonSchemaConverter
             ),
             safety_identifier: T.nilable(String),
             seed: T.nilable(Integer),
@@ -92,9 +94,8 @@ module OpenAI
             ),
             tools: T::Array[
               T.any(
-                OpenAI::StructuredOutput::JsonSchemaConverter,
-                OpenAI::Chat::ChatCompletionFunctionTool::OrHash,
-                OpenAI::Chat::ChatCompletionCustomTool::OrHash
+                T.any(OpenAI::Chat::ChatCompletionFunctionTool::OrHash, OpenAI::Chat::ChatCompletionCustomTool::OrHash),
+                OpenAI::StructuredOutput::JsonSchemaConverter
               )
             ],
             top_logprobs: T.nilable(Integer),
@@ -106,7 +107,7 @@ module OpenAI
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Chat::ChatCompletion)
-        end
+        }
         def create(
           # A list of messages comprising the conversation so far. Depending on the
           # [model](https://developers.openai.com/api/docs/models) you use, different
@@ -263,7 +264,7 @@ module OpenAI
           response_format: nil,
           # A stable identifier used to help detect users of your application that may be
           # violating OpenAI's usage policies. The IDs should be a string that uniquely
-          # identifies each user, with a maximum length of 64 characters. We recommend
+          # identifies each user, with a maximum length of 128 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -386,7 +387,7 @@ module OpenAI
         #
         # Returns a chat completion object, or a streamed sequence of chat completion
         # chunk objects if the request is streamed.
-        sig do
+        sig {
           params(
             messages: T::Array[
               T.any(
@@ -451,7 +452,7 @@ module OpenAI
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Internal::Stream[OpenAI::Chat::ChatCompletionChunk])
-        end
+        }
         def stream_raw(
           # A list of messages comprising the conversation so far. Depending on the
           # [model](https://developers.openai.com/api/docs/models) you use, different
@@ -608,7 +609,7 @@ module OpenAI
           response_format: nil,
           # A stable identifier used to help detect users of your application that may be
           # violating OpenAI's usage policies. The IDs should be a string that uniquely
-          # identifies each user, with a maximum length of 64 characters. We recommend
+          # identifies each user, with a maximum length of 128 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -711,13 +712,11 @@ module OpenAI
 
         # Get a stored chat completion. Only Chat Completions that have been created with
         # the `store` parameter set to `true` will be returned.
-        sig do
-          params(
-            completion_id: String,
-            request_options: OpenAI::RequestOptions::OrHash
+        sig {
+          params(completion_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+            OpenAI::Chat::ChatCompletion
           )
-            .returns(OpenAI::Chat::ChatCompletion)
-        end
+        }
         def retrieve(
           # The ID of the chat completion to retrieve.
           completion_id,
@@ -728,14 +727,14 @@ module OpenAI
         # Modify a stored chat completion. Only Chat Completions that have been created
         # with the `store` parameter set to `true` can be modified. Currently, the only
         # supported modification is to update the `metadata` field.
-        sig do
+        sig {
           params(
             completion_id: String,
             metadata: T.nilable(T::Hash[Symbol, String]),
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Chat::ChatCompletion)
-        end
+        }
         def update(
           # The ID of the chat completion to update.
           completion_id,
@@ -752,7 +751,7 @@ module OpenAI
 
         # List stored Chat Completions. Only Chat Completions that have been stored with
         # the `store` parameter set to `true` will be returned.
-        sig do
+        sig {
           params(
             after: String,
             limit: Integer,
@@ -762,7 +761,7 @@ module OpenAI
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Internal::CursorPage[OpenAI::Chat::ChatCompletion])
-        end
+        }
         def list(
           # Identifier for the last chat completion from the previous pagination request.
           after: nil,
@@ -783,13 +782,11 @@ module OpenAI
 
         # Delete a stored chat completion. Only Chat Completions that have been created
         # with the `store` parameter set to `true` can be deleted.
-        sig do
-          params(
-            completion_id: String,
-            request_options: OpenAI::RequestOptions::OrHash
+        sig {
+          params(completion_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+            OpenAI::Chat::ChatCompletionDeleted
           )
-            .returns(OpenAI::Chat::ChatCompletionDeleted)
-        end
+        }
         def delete(
           # The ID of the chat completion to delete.
           completion_id,