openai 0.87.0 → 0.88.0

data/lib/openai/resources/admin/organization/projects/service_accounts/api_keys.rb

@@ -11,15 +11,20 @@ module OpenAI
               #
               # @overload create(service_account_id, project_id:, expires_in_seconds: nil, name: nil, scopes: nil, request_options: {})
               #
-              # @param service_account_id [String] Path param: The ID of the service account.
+              # @param service_account_id [String]
+              #   Path param: The ID of the service account.
               #
-              # @param project_id [String] Path param: The ID of the project.
+              # @param project_id [String]
+              #   Path param: The ID of the project.
               #
-              # @param expires_in_seconds [Integer, nil] Body param: Number of seconds until the API key expires.
+              # @param expires_in_seconds [Integer, nil]
+              #   Body param: Number of seconds until the API key expires.
               #
-              # @param name [String] Body param: API key name.
+              # @param name [String]
+              #   Body param: API key name.
               #
-              # @param scopes [Array<String>] Body param: API key scopes.
+              # @param scopes [Array<String>]
+              #   Body param: API key scopes.
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #

data/lib/openai/resources/admin/organization/projects/service_accounts.rb

@@ -12,13 +12,23 @@ module OpenAI
             # Creates a new service account in the project. By default, this also returns an
             # unredacted API key for the service account.
             #
-            # @overload create(project_id, name:, create_service_account_only: nil, request_options: {})
+            # @overload create(project_id, name:, create_service_account_only: nil, expires_in_seconds: nil, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
-            # @param name [String] The name of the service account being created.
+            # @param name [String]
+            #   The name of the service account being created.
             #
-            # @param create_service_account_only [Boolean, nil] Create the service account without default roles or an API key.
+            # @param create_service_account_only [Boolean, nil]
+            #   Create the service account without default roles or an API key.
+            #
+            # @param expires_in_seconds [Integer, nil]
+            #   Number of seconds until the initial API key expires. If omitted or null, the key
+            #   does not expire unless the effective organization or project policy requires an
+            #   expiration. When a policy sets a maximum lifetime, this value must be provided
+            #   and must not exceed that limit. A non-null value cannot be used when
+            #   `create_service_account_only` is true.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -41,9 +51,11 @@ module OpenAI
             #
             # @overload retrieve(service_account_id, project_id:, request_options: {})
             #
-            # @param service_account_id [String] The ID of the service account.
+            # @param service_account_id [String]
+            #   The ID of the service account.
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -69,13 +81,17 @@ module OpenAI
             #
             # @overload update(service_account_id, project_id:, name: nil, role: nil, request_options: {})
             #
-            # @param service_account_id [String] Path param: The ID of the service account.
+            # @param service_account_id [String]
+            #   Path param: The ID of the service account.
             #
-            # @param project_id [String] Path param: The ID of the project.
+            # @param project_id [String]
+            #   Path param: The ID of the project.
             #
-            # @param name [String] Body param: The updated service account name.
+            # @param name [String]
+            #   Body param: The updated service account name.
             #
-            # @param role [Symbol, OpenAI::Models::Admin::Organization::Projects::ServiceAccountUpdateParams::Role] Body param: The updated service account role.
+            # @param role [Symbol, OpenAI::Models::Admin::Organization::Projects::ServiceAccountUpdateParams::Role]
+            #   Body param: The updated service account role.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -98,19 +114,22 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::ServiceAccountListParams} for
-            # more details.
-            #
             # Returns a list of service accounts in the project.
             #
             # @overload list(project_id, after: nil, limit: nil, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
-            # @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 request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -138,9 +157,11 @@ module OpenAI
             #
             # @overload delete(service_account_id, project_id:, request_options: {})
             #
-            # @param service_account_id [String] The ID of the service account.
+            # @param service_account_id [String]
+            #   The ID of the service account.
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

data/lib/openai/resources/admin/organization/projects/spend_alerts.rb

@@ -10,15 +10,20 @@ module OpenAI
             #
             # @overload create(project_id, currency:, interval:, notification_channel:, threshold_amount:, request_options: {})
             #
-            # @param project_id [String] The ID of the project to update.
+            # @param project_id [String]
+            #   The ID of the project to update.
             #
-            # @param currency [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertCreateParams::Currency] The currency for the threshold amount.
+            # @param currency [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertCreateParams::Currency]
+            #   The currency for the threshold amount.
             #
-            # @param interval [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertCreateParams::Interval] The time interval for evaluating spend against the threshold.
+            # @param interval [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertCreateParams::Interval]
+            #   The time interval for evaluating spend against the threshold.
             #
-            # @param notification_channel [OpenAI::Models::Admin::Organization::Projects::SpendAlertCreateParams::NotificationChannel] Email notification settings for a spend alert.
+            # @param notification_channel [OpenAI::Models::Admin::Organization::Projects::SpendAlertCreateParams::NotificationChannel]
+            #   Email notification settings for a spend alert.
             #
-            # @param threshold_amount [Integer] The alert threshold amount, in cents.
+            # @param threshold_amount [Integer]
+            #   The alert threshold amount, in cents.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -41,9 +46,11 @@ module OpenAI
             #
             # @overload retrieve(alert_id, project_id:, request_options: {})
             #
-            # @param alert_id [String] The ID of the spend alert to retrieve.
+            # @param alert_id [String]
+            #   The ID of the spend alert to retrieve.
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -69,17 +76,23 @@ module OpenAI
             #
             # @overload update(alert_id, project_id:, currency:, interval:, notification_channel:, threshold_amount:, request_options: {})
             #
-            # @param alert_id [String] Path param: The ID of the spend alert to update.
+            # @param alert_id [String]
+            #   Path param: The ID of the spend alert to update.
             #
-            # @param project_id [String] Path param: The ID of the project to update.
+            # @param project_id [String]
+            #   Path param: The ID of the project to update.
             #
-            # @param currency [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertUpdateParams::Currency] Body param: The currency for the threshold amount.
+            # @param currency [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertUpdateParams::Currency]
+            #   Body param: The currency for the threshold amount.
             #
-            # @param interval [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertUpdateParams::Interval] Body param: The time interval for evaluating spend against the threshold.
+            # @param interval [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertUpdateParams::Interval]
+            #   Body param: The time interval for evaluating spend against the threshold.
             #
-            # @param notification_channel [OpenAI::Models::Admin::Organization::Projects::SpendAlertUpdateParams::NotificationChannel] Body param: Email notification settings for a spend alert.
+            # @param notification_channel [OpenAI::Models::Admin::Organization::Projects::SpendAlertUpdateParams::NotificationChannel]
+            #   Body param: Email notification settings for a spend alert.
             #
-            # @param threshold_amount [Integer] Body param: The alert threshold amount, in cents.
+            # @param threshold_amount [Integer]
+            #   Body param: The alert threshold amount, in cents.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -102,23 +115,26 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::SpendAlertListParams} for more
-            # details.
-            #
             # Lists project spend alerts.
             #
             # @overload list(project_id, after: nil, before: nil, limit: nil, order: nil, request_options: {})
             #
-            # @param project_id [String] The ID of the project to inspect.
+            # @param project_id [String]
+            #   The ID of the project to inspect.
             #
-            # @param after [String] Cursor for pagination. Provide the ID of the last spend alert from the previous
+            # @param after [String]
+            #   Cursor for pagination. Provide the ID of the last spend alert from the previous
+            #   response to fetch the next page.
             #
-            # @param before [String] Cursor for pagination. Provide the ID of the first spend alert from the previous
+            # @param before [String]
+            #   Cursor for pagination. Provide the ID of the first spend alert from the previous
+            #   response to fetch the previous page.
             #
-            # @param limit [Integer] A limit on the number of spend alerts to return. Defaults to 20.
+            # @param limit [Integer]
+            #   A limit on the number of spend alerts to return. Defaults to 20.
             #
-            # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertListParams::Order] Sort order for the returned spend alerts.
+            # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendAlertListParams::Order]
+            #   Sort order for the returned spend alerts.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -143,9 +159,11 @@ module OpenAI
             #
             # @overload delete(alert_id, project_id:, request_options: {})
             #
-            # @param alert_id [String] The ID of the spend alert to delete.
+            # @param alert_id [String]
+            #   The ID of the spend alert to delete.
             #
-            # @param project_id [String] The ID of the project to update.
+            # @param project_id [String]
+            #   The ID of the project to update.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

data/lib/openai/resources/admin/organization/projects/spend_limit.rb

@@ -10,7 +10,8 @@ module OpenAI
             #
             # @overload retrieve(project_id, request_options: {})
             #
-            # @param project_id [String] The ID of the project whose hard spend limit is being managed.
+            # @param project_id [String]
+            #   The ID of the project whose hard spend limit is being managed.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -27,21 +28,22 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams} for more
-            # details.
-            #
             # Create or replace a project's hard spend limit.
             #
             # @overload update(project_id, currency:, interval:, threshold_amount:, request_options: {})
             #
-            # @param project_id [String] The ID of the project whose hard spend limit is being managed.
+            # @param project_id [String]
+            #   The ID of the project whose hard spend limit is being managed.
             #
-            # @param currency [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams::Currency] The currency for the threshold amount. Currently, only `USD` is supported.
+            # @param currency [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams::Currency]
+            #   The currency for the threshold amount. Currently, only `USD` is supported.
             #
-            # @param interval [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams::Interval] The time interval for evaluating spend against the threshold. Currently, only `m
+            # @param interval [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams::Interval]
+            #   The time interval for evaluating spend against the threshold. Currently, only
+            #   `month` is supported.
             #
-            # @param threshold_amount [Integer] The hard spend limit amount, in cents.
+            # @param threshold_amount [Integer]
+            #   The hard spend limit amount, in cents.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -64,7 +66,8 @@ module OpenAI
             #
             # @overload delete(project_id, request_options: {})
             #
-            # @param project_id [String] The ID of the project whose hard spend limit is being managed.
+            # @param project_id [String]
+            #   The ID of the project whose hard spend limit is being managed.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

data/lib/openai/resources/admin/organization/projects/users/roles.rb

@@ -11,11 +11,14 @@ module OpenAI
               #
               # @overload create(user_id, project_id:, role_id:, request_options: {})
               #
-              # @param user_id [String] Path param: The ID of the user that should receive the project role.
+              # @param user_id [String]
+              #   Path param: The ID of the user that should receive the project role.
               #
-              # @param project_id [String] Path param: The ID of the project to update.
+              # @param project_id [String]
+              #   Path param: The ID of the project to update.
               #
-              # @param role_id [String] Body param: Identifier of the role to assign.
+              # @param role_id [String]
+              #   Body param: Identifier of the role to assign.
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #
@@ -42,11 +45,14 @@ module OpenAI
               #
               # @overload retrieve(role_id, project_id:, user_id:, request_options: {})
               #
-              # @param role_id [String] The ID of the project role to retrieve for the user.
+              # @param role_id [String]
+              #   The ID of the project role to retrieve for the user.
               #
-              # @param project_id [String] The ID of the project to inspect.
+              # @param project_id [String]
+              #   The ID of the project to inspect.
               #
-              # @param user_id [String] The ID of the user to inspect.
+              # @param user_id [String]
+              #   The ID of the user to inspect.
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #
@@ -72,23 +78,25 @@ module OpenAI
                 )
               end
 
-              # Some parameter documentations has been truncated, see
-              # {OpenAI::Models::Admin::Organization::Projects::Users::RoleListParams} for more
-              # details.
-              #
               # Lists the project roles assigned to a user within a project.
               #
               # @overload list(user_id, project_id:, after: nil, limit: nil, order: nil, request_options: {})
               #
-              # @param user_id [String] Path param: The ID of the user to inspect.
+              # @param user_id [String]
+              #   Path param: The ID of the user to inspect.
               #
-              # @param project_id [String] Path param: The ID of the project to inspect.
+              # @param project_id [String]
+              #   Path param: The ID of the project to inspect.
               #
-              # @param after [String] Query param: Cursor for pagination. Provide the value from the previous response
+              # @param after [String]
+              #   Query param: Cursor for pagination. Provide the value from the previous
+              #   response's `next` field to continue listing project roles.
               #
-              # @param limit [Integer] Query param: A limit on the number of project role assignments to return.
+              # @param limit [Integer]
+              #   Query param: A limit on the number of project role assignments to return.
               #
-              # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::Users::RoleListParams::Order] Query param: Sort order for the returned project roles.
+              # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::Users::RoleListParams::Order]
+              #   Query param: Sort order for the returned project roles.
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #
@@ -117,11 +125,14 @@ module OpenAI
               #
               # @overload delete(role_id, project_id:, user_id:, request_options: {})
               #
-              # @param role_id [String] The ID of the project role to remove from the user.
+              # @param role_id [String]
+              #   The ID of the project role to remove from the user.
               #
-              # @param project_id [String] The ID of the project to modify.
+              # @param project_id [String]
+              #   The ID of the project to modify.
               #
-              # @param user_id [String] The ID of the user whose project role assignment should be removed.
+              # @param user_id [String]
+              #   The ID of the user whose project role assignment should be removed.
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #

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

@@ -14,13 +14,17 @@ module OpenAI
             #
             # @overload create(project_id, role:, email: nil, user_id: nil, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
-            # @param role [String] `owner` or `member`
+            # @param role [String]
+            #   `owner` or `member`
             #
-            # @param email [String, nil] Email of the user to add.
+            # @param email [String, nil]
+            #   Email of the user to add.
             #
-            # @param user_id [String, nil] The ID of the user.
+            # @param user_id [String, nil]
+            #   The ID of the user.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -43,9 +47,11 @@ module OpenAI
             #
             # @overload retrieve(user_id, project_id:, request_options: {})
             #
-            # @param user_id [String] The ID of the user.
+            # @param user_id [String]
+            #   The ID of the user.
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -71,11 +77,14 @@ module OpenAI
             #
             # @overload update(user_id, project_id:, role: nil, request_options: {})
             #
-            # @param user_id [String] Path param: The ID of the user.
+            # @param user_id [String]
+            #   Path param: The ID of the user.
             #
-            # @param project_id [String] Path param: The ID of the project.
+            # @param project_id [String]
+            #   Path param: The ID of the project.
             #
-            # @param role [String, nil] Body param: `owner` or `member`
+            # @param role [String, nil]
+            #   Body param: `owner` or `member`
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -98,19 +107,22 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::UserListParams} for more
-            # details.
-            #
             # Returns a list of users in the project.
             #
             # @overload list(project_id, after: nil, limit: nil, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
-            # @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 request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -138,9 +150,11 @@ module OpenAI
             #
             # @overload delete(user_id, project_id:, request_options: {})
             #
-            # @param user_id [String] The ID of the user.
+            # @param user_id [String]
+            #   The ID of the user.
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

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

@@ -41,21 +41,30 @@ module OpenAI
           # @return [OpenAI::Resources::Admin::Organization::Projects::Certificates]
           attr_reader :certificates
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::ProjectCreateParams} for more details.
-          #
           # Create a new project in the organization. Projects can be created and archived,
           # but cannot be deleted.
           #
           # @overload create(name:, external_key_id: nil, geography: nil, residency: nil, request_options: {})
           #
-          # @param name [String] The friendly name of the project, this name appears in reports.
+          # @param name [String]
+          #   The friendly name of the project, this name appears in reports.
           #
-          # @param external_key_id [String, nil] External key ID to associate with the project.
+          # @param external_key_id [String, nil]
+          #   External key ID to associate with the project.
           #
-          # @param geography [String, nil] Create the project with the specified data residency region. Your organization m
+          # @param geography [String, nil]
+          #   Create the project with the specified data residency region. Your organization
+          #   must have access to Data residency functionality in order to use. See
+          #   [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
+          #   to review the functionality and limitations of setting this field. Deprecated:
+          #   use `residency` instead. Do not provide both `geography` and `residency`.
           #
-          # @param residency [Symbol, OpenAI::Models::Admin::Organization::ProjectResidency, nil] Create the project with the specified residency configuration. Your organization
+          # @param residency [Symbol, OpenAI::Models::Admin::Organization::ProjectResidency, nil]
+          #   Create the project with the specified residency configuration. Your organization
+          #   must have access to the requested residency configuration in order to use it.
+          #   See
+          #   [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
+          #   to review the functionality and limitations of setting this field.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -78,7 +87,8 @@ module OpenAI
           #
           # @overload retrieve(project_id, request_options: {})
           #
-          # @param project_id [String] The ID of the project.
+          # @param project_id [String]
+          #   The ID of the project.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -95,20 +105,22 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::ProjectUpdateParams} for more details.
-          #
           # Modifies a project in the organization.
           #
           # @overload update(project_id, external_key_id: nil, geography: nil, name: nil, request_options: {})
           #
-          # @param project_id [String] The ID of the project.
+          # @param project_id [String]
+          #   The ID of the project.
           #
-          # @param external_key_id [String, nil] External key ID to associate with the project.
+          # @param external_key_id [String, nil]
+          #   External key ID to associate with the project.
           #
-          # @param geography [String, nil] Geography for the project.
+          # @param geography [String, nil]
+          #   Geography for the project. Deprecated: use `residency` when creating a project
+          #   to configure data residency. This field is retained for backward compatibility.
           #
-          # @param name [String, nil] The updated name of the project, this name appears in reports.
+          # @param name [String, nil]
+          #   The updated name of the project, this name appears in reports.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -127,18 +139,23 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::ProjectListParams} for more details.
-          #
           # Returns a list of projects.
           #
           # @overload list(after: nil, include_archived: nil, limit: 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 include_archived [Boolean] If `true` returns all projects including those that have been `archived`. Archiv
+          # @param include_archived [Boolean]
+          #   If `true` returns all projects including those that have been `archived`.
+          #   Archived projects are not included by default.
           #
-          # @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 request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -164,7 +181,8 @@ module OpenAI
           #
           # @overload archive(project_id, request_options: {})
           #
-          # @param project_id [String] The ID of the project.
+          # @param project_id [String]
+          #   The ID of the project.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #