openai 0.87.0 → 0.89.0

data/lib/openai/models/webhooks/realtime_call_incoming_webhook_event.rb

@@ -35,28 +35,30 @@ module OpenAI
         optional :object, enum: -> { OpenAI::Webhooks::RealtimeCallIncomingWebhookEvent::Object }
 
         # @!method initialize(id:, created_at:, data:, object: nil, type: :"realtime.call.incoming")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent} for more details.
-        #
         #   Sent when an incoming API SIP session is available for Realtime acceptance. The
-        #   same pending session can also emit `live.call.incoming`; the first successful
-        #   Realtime or Live accept endpoint selects the runtime surface.
+        #   same pending session can also emit `live.transport.incoming`; the first
+        #   successful Realtime or Live accept endpoint selects the runtime surface.
         #
-        #   @param id [String] The unique ID of the event.
+        #   @param id [String]
+        #     The unique ID of the event.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) of when the model response was completed.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) of when the model response was completed.
         #
-        #   @param data [OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data] Event data payload.
+        #   @param data [OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data]
+        #     Event data payload.
         #
-        #   @param object [Symbol, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Object] The object of the event. Always `event`.
+        #   @param object [Symbol, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Object]
+        #     The object of the event. Always `event`.
         #
-        #   @param type [Symbol, :"realtime.call.incoming"] The type of the event. Always `realtime.call.incoming`.
+        #   @param type [Symbol, :"realtime.call.incoming"]
+        #     The type of the event. Always `realtime.call.incoming`.
 
         # @see OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
           # @!attribute call_id
           #   The Transceiver `rtc_...` ID of the pending SIP session. The paired
-          #   `live.call.incoming` event derives its `session_id` by replacing the `rtc_`
+          #   `live.transport.incoming` event derives its `session_id` by replacing the `rtc_`
           #   prefix with `live_`. Use the ID returned by the event with the corresponding
           #   Realtime or Live API.
           #
@@ -64,7 +66,9 @@ module OpenAI
           required :call_id, String
 
           # @!attribute sip_headers
-          #   Headers from the SIP Invite.
+          #   Headers from the SIP INVITE, excluding SIP authorization headers. Retained
+          #   names, values, repeated entries, and order are preserved. Treat these values as
+          #   untrusted call metadata.
           #
           #   @return [Array<OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data::SipHeader>]
           required(
@@ -73,16 +77,18 @@ module OpenAI
           )
 
           # @!method initialize(call_id:, sip_headers:)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data} for more
-          #   details.
-          #
           #   Event data payload.
           #
-          #   @param call_id [String] The Transceiver `rtc_...` ID of the pending SIP session. The paired
+          #   @param call_id [String]
+          #     The Transceiver `rtc_...` ID of the pending SIP session. The paired
+          #     `live.transport.incoming` event derives its `session_id` by replacing the `rtc_`
+          #     prefix with `live_`. Use the ID returned by the event with the corresponding
+          #     Realtime or Live API.
           #
-          #   @param sip_headers [Array<OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data::SipHeader>] Headers from the SIP Invite.
-
+          #   @param sip_headers [Array<OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data::SipHeader>]
+          #     Headers from the SIP INVITE, excluding SIP authorization headers. Retained
+          #     names, values, repeated entries, and order are preserved. Treat these values as
+          #     untrusted call metadata.
           class SipHeader < OpenAI::Internal::Type::BaseModel
             # @!attribute name
             #   Name of the SIP Header.
@@ -97,15 +103,13 @@ module OpenAI
             required :value, String
 
             # @!method initialize(name:, value:)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data::SipHeader}
-            #   for more details.
-            #
             #   A header from the SIP Invite.
             #
-            #   @param name [String] Name of the SIP Header.
+            #   @param name [String]
+            #     Name of the SIP Header.
             #
-            #   @param value [String] Value of the SIP Header.
+            #   @param value [String]
+            #     Value of the SIP Header.
           end
         end
 

data/lib/openai/models/webhooks/response_cancelled_webhook_event.rb

@@ -35,20 +35,22 @@ module OpenAI
         optional :object, enum: -> { OpenAI::Webhooks::ResponseCancelledWebhookEvent::Object }
 
         # @!method initialize(id:, created_at:, data:, object: nil, type: :"response.cancelled")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent} for more details.
-        #
         #   Sent when a background response has been cancelled.
         #
-        #   @param id [String] The unique ID of the event.
+        #   @param id [String]
+        #     The unique ID of the event.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) of when the model response was cancelled.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) of when the model response was cancelled.
         #
-        #   @param data [OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent::Data] Event data payload.
+        #   @param data [OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent::Data]
+        #     Event data payload.
         #
-        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent::Object] The object of the event. Always `event`.
+        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent::Object]
+        #     The object of the event. Always `event`.
         #
-        #   @param type [Symbol, :"response.cancelled"] The type of the event. Always `response.cancelled`.
+        #   @param type [Symbol, :"response.cancelled"]
+        #     The type of the event. Always `response.cancelled`.
 
         # @see OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
@@ -59,13 +61,10 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent::Data} for more
-          #   details.
-          #
           #   Event data payload.
           #
-          #   @param id [String] The unique ID of the model response.
+          #   @param id [String]
+          #     The unique ID of the model response.
         end
 
         # The object of the event. Always `event`.

data/lib/openai/models/webhooks/response_completed_webhook_event.rb

@@ -35,20 +35,22 @@ module OpenAI
         optional :object, enum: -> { OpenAI::Webhooks::ResponseCompletedWebhookEvent::Object }
 
         # @!method initialize(id:, created_at:, data:, object: nil, type: :"response.completed")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent} for more details.
-        #
         #   Sent when a background response has been completed.
         #
-        #   @param id [String] The unique ID of the event.
+        #   @param id [String]
+        #     The unique ID of the event.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) of when the model response was completed.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) of when the model response was completed.
         #
-        #   @param data [OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent::Data] Event data payload.
+        #   @param data [OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent::Data]
+        #     Event data payload.
         #
-        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent::Object] The object of the event. Always `event`.
+        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent::Object]
+        #     The object of the event. Always `event`.
         #
-        #   @param type [Symbol, :"response.completed"] The type of the event. Always `response.completed`.
+        #   @param type [Symbol, :"response.completed"]
+        #     The type of the event. Always `response.completed`.
 
         # @see OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
@@ -59,13 +61,10 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent::Data} for more
-          #   details.
-          #
           #   Event data payload.
           #
-          #   @param id [String] The unique ID of the model response.
+          #   @param id [String]
+          #     The unique ID of the model response.
         end
 
         # The object of the event. Always `event`.

data/lib/openai/models/webhooks/response_failed_webhook_event.rb

@@ -35,20 +35,22 @@ module OpenAI
         optional :object, enum: -> { OpenAI::Webhooks::ResponseFailedWebhookEvent::Object }
 
         # @!method initialize(id:, created_at:, data:, object: nil, type: :"response.failed")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Webhooks::ResponseFailedWebhookEvent} for more details.
-        #
         #   Sent when a background response has failed.
         #
-        #   @param id [String] The unique ID of the event.
+        #   @param id [String]
+        #     The unique ID of the event.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) of when the model response failed.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) of when the model response failed.
         #
-        #   @param data [OpenAI::Models::Webhooks::ResponseFailedWebhookEvent::Data] Event data payload.
+        #   @param data [OpenAI::Models::Webhooks::ResponseFailedWebhookEvent::Data]
+        #     Event data payload.
         #
-        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent::Object] The object of the event. Always `event`.
+        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent::Object]
+        #     The object of the event. Always `event`.
         #
-        #   @param type [Symbol, :"response.failed"] The type of the event. Always `response.failed`.
+        #   @param type [Symbol, :"response.failed"]
+        #     The type of the event. Always `response.failed`.
 
         # @see OpenAI::Models::Webhooks::ResponseFailedWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
@@ -59,12 +61,10 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Webhooks::ResponseFailedWebhookEvent::Data} for more details.
-          #
           #   Event data payload.
           #
-          #   @param id [String] The unique ID of the model response.
+          #   @param id [String]
+          #     The unique ID of the model response.
         end
 
         # The object of the event. Always `event`.

data/lib/openai/models/webhooks/response_incomplete_webhook_event.rb

@@ -35,20 +35,22 @@ module OpenAI
         optional :object, enum: -> { OpenAI::Webhooks::ResponseIncompleteWebhookEvent::Object }
 
         # @!method initialize(id:, created_at:, data:, object: nil, type: :"response.incomplete")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent} for more details.
-        #
         #   Sent when a background response has been interrupted.
         #
-        #   @param id [String] The unique ID of the event.
+        #   @param id [String]
+        #     The unique ID of the event.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) of when the model response was interrupted.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) of when the model response was interrupted.
         #
-        #   @param data [OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent::Data] Event data payload.
+        #   @param data [OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent::Data]
+        #     Event data payload.
         #
-        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent::Object] The object of the event. Always `event`.
+        #   @param object [Symbol, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent::Object]
+        #     The object of the event. Always `event`.
         #
-        #   @param type [Symbol, :"response.incomplete"] The type of the event. Always `response.incomplete`.
+        #   @param type [Symbol, :"response.incomplete"]
+        #     The type of the event. Always `response.incomplete`.
 
         # @see OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
@@ -59,13 +61,10 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent::Data} for more
-          #   details.
-          #
           #   Event data payload.
           #
-          #   @param id [String] The unique ID of the model response.
+          #   @param id [String]
+          #     The unique ID of the model response.
         end
 
         # The object of the event. Always `event`.

data/lib/openai/models/webhooks/safety_alert_created_webhook_event.rb

@@ -36,15 +36,19 @@ module OpenAI
         # @!method initialize(id:, created_at:, data:, object: :event, type: :"safety.alert.created")
         #   Sent when an approved safety alert is available for an API project.
         #
-        #   @param id [String] The unique ID of the webhook event.
+        #   @param id [String]
+        #     The unique ID of the webhook event.
         #
-        #   @param created_at [Integer] The Unix timestamp in seconds when the event was created.
+        #   @param created_at [Integer]
+        #     The Unix timestamp in seconds when the event was created.
         #
         #   @param data [OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent::Data]
         #
-        #   @param object [Symbol, :event] Always `event`.
+        #   @param object [Symbol, :event]
+        #     Always `event`.
         #
-        #   @param type [Symbol, :"safety.alert.created"] Always `safety.alert.created`.
+        #   @param type [Symbol, :"safety.alert.created"]
+        #     Always `safety.alert.created`.
 
         # @see OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
@@ -55,7 +59,8 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   @param id [String] The safety alert ID to pass to `GET /v1/safety/alerts/{id}`.
+          #   @param id [String]
+          #     The safety alert ID to pass to `GET /v1/safety/alerts/{id}`.
         end
       end
     end

data/lib/openai/models/webhooks/safety_org_alert_created_webhook_event.rb

@@ -36,15 +36,19 @@ module OpenAI
         # @!method initialize(id:, created_at:, data:, object: :event, type: :"safety.org_alert.created")
         #   Sent when an approved safety alert is available for an enterprise workspace.
         #
-        #   @param id [String] The unique ID of the webhook event.
+        #   @param id [String]
+        #     The unique ID of the webhook event.
         #
-        #   @param created_at [Integer] The Unix timestamp in seconds when the event was created.
+        #   @param created_at [Integer]
+        #     The Unix timestamp in seconds when the event was created.
         #
         #   @param data [OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent::Data]
         #
-        #   @param object [Symbol, :event] Always `event`.
+        #   @param object [Symbol, :event]
+        #     Always `event`.
         #
-        #   @param type [Symbol, :"safety.org_alert.created"] Always `safety.org_alert.created`.
+        #   @param type [Symbol, :"safety.org_alert.created"]
+        #     Always `safety.org_alert.created`.
 
         # @see OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
@@ -55,7 +59,8 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   @param id [String] The safety alert ID to pass to `GET /v1/safety/alerts/{id}`.
+          #   @param id [String]
+          #     The safety alert ID to pass to `GET /v1/safety/alerts/{id}`.
         end
       end
     end

data/lib/openai/models/webhooks/unwrap_webhook_event.rb

@@ -39,13 +39,20 @@ module OpenAI
         # Sent when a fine-tuning job has succeeded.
         variant :"fine_tuning.job.succeeded", -> { OpenAI::Webhooks::FineTuningJobSucceededWebhookEvent }
 
+        # Deprecated: use `live.transport.incoming`. Retained for existing subscriptions
+        # during migration; new subscriptions to this event are not allowed.
         # Sent when an incoming API SIP session is available for Live acceptance. The
         # same pending session can also emit `realtime.call.incoming`; the first
         # successful Realtime or Live accept endpoint selects the runtime surface.
         variant :"live.call.incoming", -> { OpenAI::Webhooks::LiveCallIncomingWebhookEvent }
 
+        # Sent when an incoming API SIP session is available for Live acceptance. The
+        # same pending session can also emit `realtime.call.incoming`; the first
+        # successful Realtime or Live accept endpoint selects the runtime surface.
+        variant :"live.transport.incoming", -> { OpenAI::Webhooks::LiveTransportIncomingWebhookEvent }
+
         # Sent when an incoming API SIP session is available for Realtime acceptance.
-        # The same pending session can also emit `live.call.incoming`; the first
+        # The same pending session can also emit `live.transport.incoming`; the first
         # successful Realtime or Live accept endpoint selects the runtime surface.
         variant :"realtime.call.incoming", -> { OpenAI::Webhooks::RealtimeCallIncomingWebhookEvent }
 
@@ -68,7 +75,7 @@ module OpenAI
         variant :"safety.org_alert.created", -> { OpenAI::Webhooks::SafetyOrgAlertCreatedWebhookEvent }
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Webhooks::BatchCancelledWebhookEvent, OpenAI::Models::Webhooks::BatchCompletedWebhookEvent, OpenAI::Models::Webhooks::BatchExpiredWebhookEvent, OpenAI::Models::Webhooks::BatchFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunCanceledWebhookEvent, OpenAI::Models::Webhooks::EvalRunFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunSucceededWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobCancelledWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobFailedWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobSucceededWebhookEvent, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent, OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent)]
+        #   @return [Array(OpenAI::Models::Webhooks::BatchCancelledWebhookEvent, OpenAI::Models::Webhooks::BatchCompletedWebhookEvent, OpenAI::Models::Webhooks::BatchExpiredWebhookEvent, OpenAI::Models::Webhooks::BatchFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunCanceledWebhookEvent, OpenAI::Models::Webhooks::EvalRunFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunSucceededWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobCancelledWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobFailedWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobSucceededWebhookEvent, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent, OpenAI::Models::Webhooks::LiveTransportIncomingWebhookEvent, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent, OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent)]
       end
     end
   end

data/lib/openai/models.rb

@@ -196,6 +196,8 @@ module OpenAI
 
   ImagesResponse = OpenAI::Models::ImagesResponse
 
+  Live = OpenAI::Models::Live
+
   # @type [OpenAI::Internal::Type::Converter]
   Metadata = OpenAI::Models::Metadata
 

data/lib/openai/resources/admin/organization/admin_api_keys.rb

@@ -5,16 +5,15 @@ module OpenAI
     class Admin
       class Organization
         class AdminAPIKeys
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::AdminAPIKeyCreateParams} for more details.
-          #
           # Create an organization admin API key
           #
           # @overload create(name:, expires_in_seconds: nil, request_options: {})
           #
           # @param name [String]
           #
-          # @param expires_in_seconds [Integer] The number of seconds until the API key expires. Omit this field for a key that
+          # @param expires_in_seconds [Integer]
+          #   The number of seconds until the API key expires. Omit this field for a key that
+          #   does not expire.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -37,7 +36,8 @@ module OpenAI
           #
           # @overload retrieve(key_id, request_options: {})
           #
-          # @param key_id [String] The ID of the API key.
+          # @param key_id [String]
+          #   The ID of the API key.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -58,11 +58,14 @@ module OpenAI
           #
           # @overload list(after: nil, limit: nil, order: nil, request_options: {})
           #
-          # @param after [String, nil] Return keys with IDs that come after this ID in the pagination order.
+          # @param after [String, nil]
+          #   Return keys with IDs that come after this ID in the pagination order.
           #
-          # @param limit [Integer] Maximum number of keys to return.
+          # @param limit [Integer]
+          #   Maximum number of keys to return.
           #
-          # @param order [Symbol, OpenAI::Models::Admin::Organization::AdminAPIKeyListParams::Order] Order results by creation time, ascending or descending.
+          # @param order [Symbol, OpenAI::Models::Admin::Organization::AdminAPIKeyListParams::Order]
+          #   Order results by creation time, ascending or descending.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -87,7 +90,8 @@ module OpenAI
           #
           # @overload delete(key_id, request_options: {})
           #
-          # @param key_id [String] The ID of the API key to be deleted.
+          # @param key_id [String]
+          #   The ID of the API key to be deleted.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #

data/lib/openai/resources/admin/organization/audit_logs.rb

@@ -6,32 +6,54 @@ module OpenAI
       class Organization
         # List user actions and configuration changes within this organization.
         class AuditLogs
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::AuditLogListParams} for more details.
-          #
           # List user actions and configuration changes within this organization.
           #
           # @overload list(actor_emails: nil, actor_ids: nil, after: nil, before: nil, effective_at: nil, event_types: nil, limit: nil, project_ids: nil, resource_ids: nil, tenant_only: nil, request_options: {})
           #
-          # @param actor_emails [Array<String>] Return only events performed by users with these emails.
-          #
-          # @param actor_ids [Array<String>] Return only events performed by these actors. Can be a user ID, a service accoun
-          #
-          # @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
-          #
-          # @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place
-          #
-          # @param effective_at [OpenAI::Models::Admin::Organization::AuditLogListParams::EffectiveAt] Return only events whose `effective_at` (Unix seconds) is in this range.
-          #
-          # @param event_types [Array<Symbol, OpenAI::Models::Admin::Organization::AuditLogListParams::EventType>] Return only events with a `type` in one of these values. For example, `project.c
-          #
-          # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
-          #
-          # @param project_ids [Array<String>] Return only events for these projects.
-          #
-          # @param resource_ids [Array<String>] Return only events performed on these targets. For example, a project ID updated
-          #
-          # @param tenant_only [Boolean] Return only tenant-scoped events associated with this organization. Required for
+          # @param actor_emails [Array<String>]
+          #   Return only events performed by users with these emails.
+          #
+          # @param actor_ids [Array<String>]
+          #   Return only events performed by these actors. Can be a user ID, a service
+          #   account ID, or an api key tracking ID.
+          #
+          # @param after [String]
+          #   A cursor for use in pagination. `after` is an object ID that defines your place
+          #   in the list. For instance, if you make a list request and receive 100 objects,
+          #   ending with obj_foo, your subsequent call can include after=obj_foo in order to
+          #   fetch the next page of the list.
+          #
+          # @param before [String]
+          #   A cursor for use in pagination. `before` is an object ID that defines your place
+          #   in the list. For instance, if you make a list request and receive 100 objects,
+          #   starting with obj_foo, your subsequent call can include before=obj_foo in order
+          #   to fetch the previous page of the list.
+          #
+          # @param effective_at [OpenAI::Models::Admin::Organization::AuditLogListParams::EffectiveAt]
+          #   Return only events whose `effective_at` (Unix seconds) is in this range.
+          #
+          # @param event_types [Array<Symbol, OpenAI::Models::Admin::Organization::AuditLogListParams::EventType>]
+          #   Return only events with a `type` in one of these values. For example,
+          #   `project.created`. For all options, see the documentation for the
+          #   [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
+          #
+          # @param limit [Integer]
+          #   A limit on the number of objects to be returned. Limit can range between 1 and
+          #   100, and the default is 20.
+          #
+          # @param project_ids [Array<String>]
+          #   Return only events for these projects.
+          #
+          # @param resource_ids [Array<String>]
+          #   Return only events performed on these targets. For example, a project ID
+          #   updated. For ChatGPT connector role events, use the workspace connector resource
+          #   ID shown in `details.id`, such as `<workspace_id>__<connector_id>`.
+          #
+          # @param tenant_only [Boolean]
+          #   Return only tenant-scoped events associated with this organization. Required for
+          #   tenant-scoped events such as `role.bound_to_resource` and
+          #   `role.unbound_from_resource`. When `true`, all supplied event types must be
+          #   tenant-scoped.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #

data/lib/openai/resources/admin/organization/certificates.rb

@@ -12,9 +12,11 @@ module OpenAI
           #
           # @overload create(certificate:, name: nil, request_options: {})
           #
-          # @param certificate [String] The certificate content in PEM format
+          # @param certificate [String]
+          #   The certificate content in PEM format
           #
-          # @param name [String] An optional name for the certificate
+          # @param name [String]
+          #   An optional name for the certificate
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -33,19 +35,18 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::CertificateRetrieveParams} for more
-          # details.
-          #
           # Get a certificate that has been uploaded to the organization.
           #
           # You can get a certificate regardless of whether it is active or not.
           #
           # @overload retrieve(certificate_id, include: nil, request_options: {})
           #
-          # @param certificate_id [String] Unique ID of the certificate to retrieve.
+          # @param certificate_id [String]
+          #   Unique ID of the certificate to retrieve.
           #
-          # @param include [Array<Symbol, OpenAI::Models::Admin::Organization::CertificateRetrieveParams::Include>] A list of additional fields to include in the response. Currently the only suppo
+          # @param include [Array<Symbol, OpenAI::Models::Admin::Organization::CertificateRetrieveParams::Include>]
+          #   A list of additional fields to include in the response. Currently the only
+          #   supported value is `content` to fetch the PEM content of the certificate.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -69,9 +70,11 @@ module OpenAI
           #
           # @overload update(certificate_id, name: nil, request_options: {})
           #
-          # @param certificate_id [String] Unique ID of the certificate to modify.
+          # @param certificate_id [String]
+          #   Unique ID of the certificate to modify.
           #
-          # @param name [String] The updated name for the certificate
+          # @param name [String]
+          #   The updated name for the certificate
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -90,18 +93,23 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::CertificateListParams} for more details.
-          #
           # List uploaded certificates for this organization.
           #
           # @overload list(after: nil, limit: nil, order: nil, request_options: {})
           #
-          # @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
+          # @param after [String]
+          #   A cursor for use in pagination. `after` is an object ID that defines your place
+          #   in the list. For instance, if you make a list request and receive 100 objects,
+          #   ending with obj_foo, your subsequent call can include after=obj_foo in order to
+          #   fetch the next page of the list.
           #
-          # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
+          # @param limit [Integer]
+          #   A limit on the number of objects to be returned. Limit can range between 1 and
+          #   100, and the default is 20.
           #
-          # @param order [Symbol, OpenAI::Models::Admin::Organization::CertificateListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+          # @param order [Symbol, OpenAI::Models::Admin::Organization::CertificateListParams::Order]
+          #   Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+          #   order and `desc` for descending order.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -128,7 +136,8 @@ module OpenAI
           #
           # @overload delete(certificate_id, request_options: {})
           #
-          # @param certificate_id [String] Unique ID of the certificate to delete.
+          # @param certificate_id [String]
+          #   Unique ID of the certificate to delete.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #

data/lib/openai/resources/admin/organization/data_retention.rb

@@ -28,7 +28,8 @@ module OpenAI
           #
           # @overload update(retention_type:, request_options: {})
           #
-          # @param retention_type [Symbol, OpenAI::Models::Admin::Organization::DataRetentionUpdateParams::RetentionType] The desired organization data retention type.
+          # @param retention_type [Symbol, OpenAI::Models::Admin::Organization::DataRetentionUpdateParams::RetentionType]
+          #   The desired organization data retention type.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #