openai 0.87.0 → 0.88.0

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

@@ -5,19 +5,22 @@ module OpenAI
     class Admin
       class Organization
         class Invites
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::InviteCreateParams} for more details.
-          #
           # Create an invite for a user to the organization. The invite must be accepted by
           # the user before they have access to the organization.
           #
           # @overload create(email:, role:, projects: nil, request_options: {})
           #
-          # @param email [String] Send an email to this address
+          # @param email [String]
+          #   Send an email to this address
           #
-          # @param role [Symbol, OpenAI::Models::Admin::Organization::InviteCreateParams::Role] `owner` or `reader`
+          # @param role [Symbol, OpenAI::Models::Admin::Organization::InviteCreateParams::Role]
+          #   `owner` or `reader`
           #
-          # @param projects [Array<OpenAI::Models::Admin::Organization::InviteCreateParams::Project>] An array of projects to which membership is granted at the same time the org inv
+          # @param projects [Array<OpenAI::Models::Admin::Organization::InviteCreateParams::Project>]
+          #   An array of projects to which membership is granted at the same time the org
+          #   invite is accepted. If omitted, the user will be invited to the default project
+          #   for compatibility with legacy behavior. If empty list is passed, the user will
+          #   not be invited to any projects, including the default one.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -40,7 +43,8 @@ module OpenAI
           #
           # @overload retrieve(invite_id, request_options: {})
           #
-          # @param invite_id [String] The ID of the invite to retrieve.
+          # @param invite_id [String]
+          #   The ID of the invite to retrieve.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -57,16 +61,19 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::InviteListParams} for more details.
-          #
           # Returns a list of invites in the organization.
           #
           # @overload list(after: 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 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]
           #
@@ -91,7 +98,8 @@ module OpenAI
           #
           # @overload delete(invite_id, request_options: {})
           #
-          # @param invite_id [String] The ID of the invite to delete.
+          # @param invite_id [String]
+          #   The ID of the invite to delete.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #

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

@@ -10,9 +10,11 @@ module OpenAI
             #
             # @overload retrieve(api_key_id, project_id:, request_options: {})
             #
-            # @param api_key_id [String] The ID of the API key.
+            # @param api_key_id [String]
+            #   The ID of the API key.
             #
-            # @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]
             #
@@ -34,21 +36,29 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::APIKeyListParams} for more
-            # details.
-            #
             # Returns a list of API keys in the project.
             #
             # @overload list(project_id, after: nil, limit: nil, owner_project_access: 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 owner_project_access [Symbol, OpenAI::Models::Admin::Organization::Projects::APIKeyListParams::OwnerProjectAccess] Filter API keys by whether the owner currently has effective access to the proje
+            # @param owner_project_access [Symbol, OpenAI::Models::Admin::Organization::Projects::APIKeyListParams::OwnerProjectAccess]
+            #   Filter API keys by whether the owner currently has effective access to the
+            #   project. Use `active` for owners with access, `inactive` for owners without
+            #   access, or `any` for all enabled project API keys. If omitted, the endpoint
+            #   applies its existing membership-based visibility rules, which may exclude some
+            #   enabled keys.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -76,9 +86,11 @@ module OpenAI
             #
             # @overload delete(api_key_id, project_id:, request_options: {})
             #
-            # @param api_key_id [String] The ID of the API key.
+            # @param api_key_id [String]
+            #   The ID of the API key.
             #
-            # @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/certificates.rb

@@ -6,21 +6,26 @@ module OpenAI
       class Organization
         class Projects
           class Certificates
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::CertificateListParams} for more
-            # details.
-            #
             # List certificates for this project.
             #
             # @overload list(project_id, after: nil, limit: nil, order: 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 order [Symbol, OpenAI::Models::Admin::Organization::Projects::CertificateListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+            # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::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]
             #
@@ -47,7 +52,8 @@ module OpenAI
             #
             # @overload activate(project_id, certificate_ids:, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
             # @param certificate_ids [Array<String>]
             #
@@ -74,7 +80,8 @@ module OpenAI
             #
             # @overload deactivate(project_id, certificate_ids:, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
             # @param certificate_ids [Array<String>]
             #

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

@@ -10,7 +10,8 @@ module OpenAI
             #
             # @overload retrieve(project_id, 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 request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -31,9 +32,11 @@ module OpenAI
             #
             # @overload update(project_id, retention_type:, 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 retention_type [Symbol, OpenAI::Models::Admin::Organization::Projects::DataRetentionUpdateParams::RetentionType] The desired project data retention type.
+            # @param retention_type [Symbol, OpenAI::Models::Admin::Organization::Projects::DataRetentionUpdateParams::RetentionType]
+            #   The desired project data retention type.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

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

@@ -11,11 +11,14 @@ module OpenAI
               #
               # @overload create(group_id, project_id:, role_id:, request_options: {})
               #
-              # @param group_id [String] Path param: The ID of the group that should receive the project role.
+              # @param group_id [String]
+              #   Path param: The ID of the group 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:, group_id:, request_options: {})
               #
-              # @param role_id [String] The ID of the project role to retrieve for the group.
+              # @param role_id [String]
+              #   The ID of the project role to retrieve for the group.
               #
-              # @param project_id [String] The ID of the project to inspect.
+              # @param project_id [String]
+              #   The ID of the project to inspect.
               #
-              # @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]
               #
@@ -72,23 +78,25 @@ module OpenAI
                 )
               end
 
-              # Some parameter documentations has been truncated, see
-              # {OpenAI::Models::Admin::Organization::Projects::Groups::RoleListParams} for more
-              # details.
-              #
               # Lists the project roles assigned to a group within a project.
               #
               # @overload list(group_id, project_id:, after: nil, limit: nil, order: nil, request_options: {})
               #
-              # @param group_id [String] Path param: The ID of the group to inspect.
+              # @param group_id [String]
+              #   Path param: The ID of the group 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::Groups::RoleListParams::Order] Query param: Sort order for the returned project roles.
+              # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::Groups::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:, group_id:, request_options: {})
               #
-              # @param role_id [String] The ID of the project role to remove from the group.
+              # @param role_id [String]
+              #   The ID of the project role to remove from the group.
               #
-              # @param project_id [String] The ID of the project to modify.
+              # @param project_id [String]
+              #   The ID of the project to modify.
               #
-              # @param group_id [String] The ID of the group whose project role assignment should be removed.
+              # @param group_id [String]
+              #   The ID of the group whose project role assignment should be removed.
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #

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

@@ -13,11 +13,14 @@ module OpenAI
             #
             # @overload create(project_id, group_id:, role:, 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 group_id [String] Identifier of the group to add to the project.
+            # @param group_id [String]
+            #   Identifier of the group to add to the project.
             #
-            # @param role [String] Identifier of the project role to grant to the group.
+            # @param role [String]
+            #   Identifier of the project role to grant to the group.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -40,11 +43,14 @@ module OpenAI
             #
             # @overload retrieve(group_id, project_id:, group_type: nil, request_options: {})
             #
-            # @param group_id [String] Path param: The ID of the group to retrieve.
+            # @param group_id [String]
+            #   Path param: The ID of the group to retrieve.
             #
-            # @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 group_type [Symbol, OpenAI::Models::Admin::Organization::Projects::GroupRetrieveParams::GroupType] Query param: The type of group to retrieve.
+            # @param group_type [Symbol, OpenAI::Models::Admin::Organization::Projects::GroupRetrieveParams::GroupType]
+            #   Query param: The type of group to retrieve.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -68,21 +74,22 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::GroupListParams} for more
-            # details.
-            #
             # Lists the groups that have access to a project.
             #
             # @overload list(project_id, after: 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 group from the previous respon
+            # @param after [String]
+            #   Cursor for pagination. Provide the ID of the last group from the previous
+            #   response to fetch the next page.
             #
-            # @param limit [Integer] A limit on the number of project groups to return. Defaults to 20.
+            # @param limit [Integer]
+            #   A limit on the number of project groups to return. Defaults to 20.
             #
-            # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::GroupListParams::Order] Sort order for the returned groups.
+            # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::GroupListParams::Order]
+            #   Sort order for the returned groups.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -107,9 +114,11 @@ module OpenAI
             #
             # @overload delete(group_id, project_id:, request_options: {})
             #
-            # @param group_id [String] The ID of the group to remove from the project.
+            # @param group_id [String]
+            #   The ID of the group to remove from the project.
             #
-            # @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/hosted_tool_permissions.rb

@@ -10,7 +10,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]
             #
@@ -31,17 +32,23 @@ module OpenAI
             #
             # @overload update(project_id, code_interpreter: nil, file_search: nil, image_generation: nil, mcp: nil, web_search: nil, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
-            # @param code_interpreter [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::CodeInterpreter, nil] The code interpreter permission update.
+            # @param code_interpreter [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::CodeInterpreter, nil]
+            #   The code interpreter permission update.
             #
-            # @param file_search [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::FileSearch, nil] The file search permission update.
+            # @param file_search [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::FileSearch, nil]
+            #   The file search permission update.
             #
-            # @param image_generation [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::ImageGeneration, nil] The image generation permission update.
+            # @param image_generation [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::ImageGeneration, nil]
+            #   The image generation permission update.
             #
-            # @param mcp [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::Mcp, nil] The MCP permission update.
+            # @param mcp [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::Mcp, nil]
+            #   The MCP permission update.
             #
-            # @param web_search [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::WebSearch, nil] The web search permission update.
+            # @param web_search [OpenAI::Models::Admin::Organization::Projects::HostedToolPermissionUpdateParams::WebSearch, nil]
+            #   The web search permission update.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

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

@@ -10,7 +10,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]
             #
@@ -31,11 +32,14 @@ module OpenAI
             #
             # @overload update(project_id, mode:, model_ids:, request_options: {})
             #
-            # @param project_id [String] The ID of the project.
+            # @param project_id [String]
+            #   The ID of the project.
             #
-            # @param mode [Symbol, OpenAI::Models::Admin::Organization::Projects::ModelPermissionUpdateParams::Mode] The model permissions mode to apply.
+            # @param mode [Symbol, OpenAI::Models::Admin::Organization::Projects::ModelPermissionUpdateParams::Mode]
+            #   The model permissions mode to apply.
             #
-            # @param model_ids [Array<String>] The model IDs included in this permissions policy.
+            # @param model_ids [Array<String>]
+            #   The model IDs included in this permissions policy.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -58,7 +62,8 @@ module OpenAI
             #
             # @overload delete(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]
             #

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

@@ -6,21 +6,27 @@ module OpenAI
       class Organization
         class Projects
           class RateLimits
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::RateLimitListRateLimitsParams}
-            # for more details.
-            #
             # Returns the rate limits per model for a project.
             #
             # @overload list_rate_limits(project_id, after: nil, before: 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 before [String] A cursor for use in pagination. `before` 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
+            #   in the list. For instance, if you make a list request and receive 100 objects,
+            #   beginning with obj_foo, your subsequent call can include before=obj_foo in order
+            #   to fetch the previous page of the list.
             #
-            # @param limit [Integer] A limit on the number of objects to be returned. The default is 100.
+            # @param limit [Integer]
+            #   A limit on the number of objects to be returned. The default is 100.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -43,29 +49,35 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::RateLimitUpdateRateLimitParams}
-            # for more details.
-            #
             # Updates a project rate limit.
             #
             # @overload update_rate_limit(rate_limit_id, project_id:, batch_1_day_max_input_tokens: nil, max_audio_megabytes_per_1_minute: nil, max_images_per_1_minute: nil, max_requests_per_1_day: nil, max_requests_per_1_minute: nil, max_tokens_per_1_minute: nil, request_options: {})
             #
-            # @param rate_limit_id [String] Path param: The ID of the rate limit.
+            # @param rate_limit_id [String]
+            #   Path param: The ID of the rate limit.
             #
-            # @param project_id [String] Path param: The ID of the project.
+            # @param project_id [String]
+            #   Path param: The ID of the project.
             #
-            # @param batch_1_day_max_input_tokens [Integer] Body param: The maximum batch input tokens per day. Only relevant for certain mo
+            # @param batch_1_day_max_input_tokens [Integer]
+            #   Body param: The maximum batch input tokens per day. Only relevant for certain
+            #   models.
             #
-            # @param max_audio_megabytes_per_1_minute [Integer] Body param: The maximum audio megabytes per minute. Only relevant for certain mo
+            # @param max_audio_megabytes_per_1_minute [Integer]
+            #   Body param: The maximum audio megabytes per minute. Only relevant for certain
+            #   models.
             #
-            # @param max_images_per_1_minute [Integer] Body param: The maximum images per minute. Only relevant for certain models.
+            # @param max_images_per_1_minute [Integer]
+            #   Body param: The maximum images per minute. Only relevant for certain models.
             #
-            # @param max_requests_per_1_day [Integer] Body param: The maximum requests per day. Only relevant for certain models.
+            # @param max_requests_per_1_day [Integer]
+            #   Body param: The maximum requests per day. Only relevant for certain models.
             #
-            # @param max_requests_per_1_minute [Integer] Body param: The maximum requests per minute.
+            # @param max_requests_per_1_minute [Integer]
+            #   Body param: The maximum requests per minute.
             #
-            # @param max_tokens_per_1_minute [Integer] Body param: The maximum tokens per minute.
+            # @param max_tokens_per_1_minute [Integer]
+            #   Body param: The maximum tokens per minute.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

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

@@ -10,13 +10,17 @@ module OpenAI
             #
             # @overload create(project_id, permissions:, role_name:, description: nil, 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 permissions [Array<String>] Permissions to grant to the role.
+            # @param permissions [Array<String>]
+            #   Permissions to grant to the role.
             #
-            # @param role_name [String] Unique name for the role.
+            # @param role_name [String]
+            #   Unique name for the role.
             #
-            # @param description [String, nil] Optional description of the role.
+            # @param description [String, nil]
+            #   Optional description of the role.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -39,9 +43,11 @@ module OpenAI
             #
             # @overload retrieve(role_id, project_id:, request_options: {})
             #
-            # @param role_id [String] The ID of the role to retrieve.
+            # @param role_id [String]
+            #   The ID of the role 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]
             #
@@ -67,15 +73,20 @@ module OpenAI
             #
             # @overload update(role_id, project_id:, description: nil, permissions: nil, role_name: nil, request_options: {})
             #
-            # @param role_id [String] Path param: The ID of the role to update.
+            # @param role_id [String]
+            #   Path param: The ID of the role 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 description [String, nil] Body param: New description for the role.
+            # @param description [String, nil]
+            #   Body param: New description for the role.
             #
-            # @param permissions [Array<String>, nil] Body param: Updated set of permissions for the role.
+            # @param permissions [Array<String>, nil]
+            #   Body param: Updated set of permissions for the role.
             #
-            # @param role_name [String, nil] Body param: New name for the role.
+            # @param role_name [String, nil]
+            #   Body param: New name for the role.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -98,21 +109,22 @@ module OpenAI
               )
             end
 
-            # Some parameter documentations has been truncated, see
-            # {OpenAI::Models::Admin::Organization::Projects::RoleListParams} for more
-            # details.
-            #
             # Lists the roles configured for a project.
             #
             # @overload list(project_id, after: 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 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 roles.
             #
-            # @param limit [Integer] A limit on the number of roles to return. Defaults to 1000.
+            # @param limit [Integer]
+            #   A limit on the number of roles to return. Defaults to 1000.
             #
-            # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::RoleListParams::Order] Sort order for the returned roles.
+            # @param order [Symbol, OpenAI::Models::Admin::Organization::Projects::RoleListParams::Order]
+            #   Sort order for the returned roles.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -137,9 +149,11 @@ module OpenAI
             #
             # @overload delete(role_id, project_id:, request_options: {})
             #
-            # @param role_id [String] The ID of the role to delete.
+            # @param role_id [String]
+            #   The ID of the role 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]
             #