openai 0.86.0 → 0.88.0

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

@@ -35,34 +35,38 @@ module OpenAI
         optional :object, enum: -> { OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object }
 
         # @!method initialize(id:, created_at:, data:, object: nil, type: :"live.call.incoming")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent} for more details.
-        #
         #   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.
         #
-        #   @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 event was created.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) of when the event was created.
         #
-        #   @param data [OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::Data] Event data payload.
+        #   @param data [OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::Data]
+        #     Event data payload.
         #
-        #   @param object [Symbol, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::Object] The object of the event. Always `event`.
+        #   @param object [Symbol, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::Object]
+        #     The object of the event. Always `event`.
         #
-        #   @param type [Symbol, :"live.call.incoming"] The type of the event. Always `live.call.incoming`.
+        #   @param type [Symbol, :"live.call.incoming"]
+        #     The type of the event. Always `live.call.incoming`.
 
         # @see OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
           # @!attribute session_id
-          #   The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-          #   as `call_id` in `realtime.call.incoming`.
+          #   The `live_...` ID of the pending SIP session. Forward this value unchanged when
+          #   accepting or rejecting the call through the Live API.
           #
           #   @return [String]
           required :session_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::LiveCallIncomingWebhookEvent::Data::SipHeader>]
           required(
@@ -71,15 +75,16 @@ module OpenAI
           )
 
           # @!method initialize(session_id:, sip_headers:)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::Data} for more details.
-          #
           #   Event data payload.
           #
-          #   @param session_id [String] The Transceiver `rtc_...` ID of the pending SIP session. The same
+          #   @param session_id [String]
+          #     The `live_...` ID of the pending SIP session. Forward this value unchanged when
+          #     accepting or rejecting the call through the Live API.
           #
-          #   @param sip_headers [Array<OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::Data::SipHeader>] Headers from the SIP Invite.
-
+          #   @param sip_headers [Array<OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::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.
@@ -94,15 +99,13 @@ module OpenAI
             required :value, String
 
             # @!method initialize(name:, value:)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent::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/realtime_call_incoming_webhook_event.rb

@@ -35,34 +35,40 @@ 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.
         #
-        #   @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 same value appears
-          #   as `session_id` in `live.call.incoming`.
+          #   The Transceiver `rtc_...` ID of the pending SIP session. The paired
+          #   `live.call.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.
           #
           #   @return [String]
           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(
@@ -71,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 same
+          #   @param call_id [String]
+          #     The Transceiver `rtc_...` ID of the pending SIP session. The paired
+          #     `live.call.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.
@@ -95,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/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]
           #