openai 0.87.0 → 0.88.0

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]
           #

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]
           #

data/lib/openai/resources/admin/organization/groups/roles.rb

@@ -10,9 +10,11 @@ module OpenAI
             #
             # @overload create(group_id, role_id:, request_options: {})
             #
-            # @param group_id [String] The ID of the group that should receive the organization role.
+            # @param group_id [String]
+            #   The ID of the group that should receive the organization role.
             #
-            # @param role_id [String] Identifier of the role to assign.
+            # @param role_id [String]
+            #   Identifier of the role to assign.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -35,9 +37,11 @@ module OpenAI
             #
             # @overload retrieve(role_id, group_id:, request_options: {})
             #
-            # @param role_id [String] The ID of the organization role to retrieve for the group.
+            # @param role_id [String]
+            #   The ID of the organization role to retrieve for the group.
             #
-            # @param group_id [String] The ID of the group to inspect.
+            # @param group_id [String]
+            #   The ID of the group to inspect.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -59,20 +63,22 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Groups::RoleListParams} for more details.
-            #
             # Lists the organization roles assigned to a group within the organization.
             #
             # @overload list(group_id, after: nil, limit: nil, order: nil, request_options: {})
             #
-            # @param group_id [String] The ID of the group whose organization role assignments you want to list.
+            # @param group_id [String]
+            #   The ID of the group whose organization role assignments you want to list.
             #
-            # @param after [String] Cursor for pagination. Provide the value from the previous response's `next` fie
+            # @param after [String]
+            #   Cursor for pagination. Provide the value from the previous response's `next`
+            #   field to continue listing organization roles.
             #
-            # @param limit [Integer] A limit on the number of organization role assignments to return.
+            # @param limit [Integer]
+            #   A limit on the number of organization role assignments to return.
             #
-            # @param order [Symbol, OpenAI::Models::Admin::Organization::Groups::RoleListParams::Order] Sort order for the returned organization roles.
+            # @param order [Symbol, OpenAI::Models::Admin::Organization::Groups::RoleListParams::Order]
+            #   Sort order for the returned organization roles.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -97,9 +103,11 @@ module OpenAI
             #
             # @overload delete(role_id, group_id:, request_options: {})
             #
-            # @param role_id [String] The ID of the organization role to remove from the group.
+            # @param role_id [String]
+            #   The ID of the organization role to remove from the group.
             #
-            # @param group_id [String] The ID of the group to modify.
+            # @param group_id [String]
+            #   The ID of the group to modify.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

data/lib/openai/resources/admin/organization/groups/users.rb

@@ -10,9 +10,11 @@ module OpenAI
             #
             # @overload create(group_id, user_id:, request_options: {})
             #
-            # @param group_id [String] The ID of the group to update.
+            # @param group_id [String]
+            #   The ID of the group to update.
             #
-            # @param user_id [String] Identifier of the user to add to the group.
+            # @param user_id [String]
+            #   Identifier of the user to add to the group.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -35,9 +37,11 @@ module OpenAI
             #
             # @overload retrieve(user_id, group_id:, request_options: {})
             #
-            # @param user_id [String] The ID of the user to retrieve from the group.
+            # @param user_id [String]
+            #   The ID of the user to retrieve from the group.
             #
-            # @param group_id [String] The ID of the group to inspect.
+            # @param group_id [String]
+            #   The ID of the group to inspect.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -59,20 +63,23 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Groups::UserListParams} for more details.
-            #
             # Lists the users assigned to a group.
             #
             # @overload list(group_id, after: nil, limit: nil, order: nil, request_options: {})
             #
-            # @param group_id [String] The ID of the group to inspect.
+            # @param group_id [String]
+            #   The ID of the group to inspect.
             #
-            # @param after [String] A cursor for use in pagination. Provide the ID of the last user from the previou
+            # @param after [String]
+            #   A cursor for use in pagination. Provide the ID of the last user from the
+            #   previous list response to retrieve the next page.
             #
-            # @param limit [Integer] A limit on the number of users to be returned. Limit can range between 0 and 100
+            # @param limit [Integer]
+            #   A limit on the number of users to be returned. Limit can range between 0 and
+            #   1000, and the default is 100.
             #
-            # @param order [Symbol, OpenAI::Models::Admin::Organization::Groups::UserListParams::Order] Specifies the sort order of users in the list.
+            # @param order [Symbol, OpenAI::Models::Admin::Organization::Groups::UserListParams::Order]
+            #   Specifies the sort order of users in the list.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -97,9 +104,11 @@ module OpenAI
             #
             # @overload delete(user_id, group_id:, request_options: {})
             #
-            # @param user_id [String] The ID of the user to remove from the group.
+            # @param user_id [String]
+            #   The ID of the user to remove from the group.
             #
-            # @param group_id [String] The ID of the group to update.
+            # @param group_id [String]
+            #   The ID of the group to update.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

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

@@ -15,7 +15,8 @@ module OpenAI
           #
           # @overload create(name:, request_options: {})
           #
-          # @param name [String] Human readable name for the group.
+          # @param name [String]
+          #   Human readable name for the group.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -38,7 +39,8 @@ module OpenAI
           #
           # @overload retrieve(group_id, request_options: {})
           #
-          # @param group_id [String] The ID of the group to retrieve.
+          # @param group_id [String]
+          #   The ID of the group to retrieve.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -59,9 +61,11 @@ module OpenAI
           #
           # @overload update(group_id, name:, request_options: {})
           #
-          # @param group_id [String] The ID of the group to update.
+          # @param group_id [String]
+          #   The ID of the group to update.
           #
-          # @param name [String] New display name for the group.
+          # @param name [String]
+          #   New display name for the group.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -80,18 +84,22 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::GroupListParams} for more details.
-          #
           # Lists all groups in the organization.
           #
           # @overload list(after: nil, limit: nil, order: nil, request_options: {})
           #
-          # @param after [String] A cursor for use in pagination. `after` is a group ID that defines your place in
+          # @param after [String]
+          #   A cursor for use in pagination. `after` is a group ID that defines your place in
+          #   the list. For instance, if you make a list request and receive 100 objects,
+          #   ending with group_abc, your subsequent call can include `after=group_abc` in
+          #   order to fetch the next page of the list.
           #
-          # @param limit [Integer] A limit on the number of groups to be returned. Limit can range between 0 and 10
+          # @param limit [Integer]
+          #   A limit on the number of groups to be returned. Limit can range between 0 and
+          #   1000, and the default is 100.
           #
-          # @param order [Symbol, OpenAI::Models::Admin::Organization::GroupListParams::Order] Specifies the sort order of the returned groups.
+          # @param order [Symbol, OpenAI::Models::Admin::Organization::GroupListParams::Order]
+          #   Specifies the sort order of the returned groups.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -116,7 +124,8 @@ module OpenAI
           #
           # @overload delete(group_id, request_options: {})
           #
-          # @param group_id [String] The ID of the group to delete.
+          # @param group_id [String]
+          #   The ID of the group to delete.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #