openai 0.87.0 → 0.89.0

data/lib/openai/resources/safety/alerts.rb

@@ -8,7 +8,8 @@ module OpenAI
         #
         # @overload retrieve(id, request_options: {})
         #
-        # @param id [String] Project safety alert ID
+        # @param id [String]
+        #   Project safety alert ID
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/skills/content.rb

@@ -8,7 +8,8 @@ module OpenAI
         #
         # @overload retrieve(skill_id, request_options: {})
         #
-        # @param skill_id [String] The identifier of the skill to download.
+        # @param skill_id [String]
+        #   The identifier of the skill to download.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/skills/versions/content.rb

@@ -9,9 +9,11 @@ module OpenAI
           #
           # @overload retrieve(version, skill_id:, request_options: {})
           #
-          # @param version [String] The skill version number.
+          # @param version [String]
+          #   The skill version number.
           #
-          # @param skill_id [String] The identifier of the skill.
+          # @param skill_id [String]
+          #   The identifier of the skill.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #

data/lib/openai/resources/skills/versions.rb

@@ -15,11 +15,18 @@ module OpenAI
         #
         # @overload create(skill_id, default: nil, files: nil, request_options: {})
         #
-        # @param skill_id [String] The identifier of the skill to version.
+        # @param skill_id [String]
+        #   The identifier of the skill to version.
         #
-        # @param default [Boolean] Whether to set this version as the default.
+        # @param default [Boolean]
+        #   Whether to set this version as the default.
         #
-        # @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart] Skill files to upload (directory upload) or a single zip file.
+        # @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart]
+        #   Skill files to upload (directory upload) or a single zip file.
+        #
+        #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+        #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+        #   content type.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -43,9 +50,11 @@ module OpenAI
         #
         # @overload retrieve(version, skill_id:, request_options: {})
         #
-        # @param version [String] The version number to retrieve.
+        # @param version [String]
+        #   The version number to retrieve.
         #
-        # @param skill_id [String] The identifier of the skill.
+        # @param skill_id [String]
+        #   The identifier of the skill.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -71,13 +80,17 @@ module OpenAI
         #
         # @overload list(skill_id, after: nil, limit: nil, order: nil, request_options: {})
         #
-        # @param skill_id [String] The identifier of the skill.
+        # @param skill_id [String]
+        #   The identifier of the skill.
         #
-        # @param after [String] The skill version ID to start after.
+        # @param after [String]
+        #   The skill version ID to start after.
         #
-        # @param limit [Integer] Number of versions to retrieve.
+        # @param limit [Integer]
+        #   Number of versions to retrieve.
         #
-        # @param order [Symbol, OpenAI::Models::Skills::VersionListParams::Order] Sort order of results by version number.
+        # @param order [Symbol, OpenAI::Models::Skills::VersionListParams::Order]
+        #   Sort order of results by version number.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -102,9 +115,11 @@ module OpenAI
         #
         # @overload delete(version, skill_id:, request_options: {})
         #
-        # @param version [String] The skill version number.
+        # @param version [String]
+        #   The skill version number.
         #
-        # @param skill_id [String] The identifier of the skill.
+        # @param skill_id [String]
+        #   The identifier of the skill.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/skills.rb

@@ -17,7 +17,12 @@ module OpenAI
       #
       # @overload create(files: nil, request_options: {})
       #
-      # @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart] Skill files to upload (directory upload) or a single zip file.
+      # @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart]
+      #   Skill files to upload (directory upload) or a single zip file.
+      #
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -41,7 +46,8 @@ module OpenAI
       #
       # @overload retrieve(skill_id, request_options: {})
       #
-      # @param skill_id [String] The identifier of the skill to retrieve.
+      # @param skill_id [String]
+      #   The identifier of the skill to retrieve.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -62,9 +68,11 @@ module OpenAI
       #
       # @overload update(skill_id, default_version:, request_options: {})
       #
-      # @param skill_id [String] The identifier of the skill.
+      # @param skill_id [String]
+      #   The identifier of the skill.
       #
-      # @param default_version [String] The skill version number to set as default.
+      # @param default_version [String]
+      #   The skill version number to set as default.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -83,18 +91,19 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::SkillListParams} for more details.
-      #
       # List all skills for the current project.
       #
       # @overload list(after: nil, limit: nil, order: nil, request_options: {})
       #
-      # @param after [String] Identifier for the last item from the previous pagination request
+      # @param after [String]
+      #   Identifier for the last item from the previous pagination request
       #
-      # @param limit [Integer] Number of items to retrieve
+      # @param limit [Integer]
+      #   Number of items to retrieve
       #
-      # @param order [Symbol, OpenAI::Models::SkillListParams::Order] Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      # @param order [Symbol, OpenAI::Models::SkillListParams::Order]
+      #   Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      #   descending order.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -119,7 +128,8 @@ module OpenAI
       #
       # @overload delete(skill_id, request_options: {})
       #
-      # @param skill_id [String] The identifier of the skill to delete.
+      # @param skill_id [String]
+      #   The identifier of the skill to delete.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/resources/uploads/parts.rb

@@ -5,20 +5,18 @@ module OpenAI
     class Uploads
       # Use Uploads to upload large files in multiple parts.
       class Parts
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Uploads::PartCreateParams} for more details.
-        #
         # Adds a
-        # [Part](https://platform.openai.com/docs/api-reference/uploads/part-object) to an
-        # [Upload](https://platform.openai.com/docs/api-reference/uploads/object) object.
-        # A Part represents a chunk of bytes from the file you are trying to upload.
+        # [Part](https://developers.openai.com/api/reference/resources/uploads/subresources/parts)
+        # to an [Upload](https://developers.openai.com/api/reference/resources/uploads)
+        # object. A Part represents a chunk of bytes from the file you are trying to
+        # upload.
         #
         # Each Part can be at most 64 MB, and you can add Parts until you hit the Upload
         # maximum of 8 GB.
         #
         # It is possible to add multiple Parts in parallel. You can decide the intended
         # order of the Parts when you
-        # [complete the Upload](https://platform.openai.com/docs/api-reference/uploads/complete).
+        # [complete the Upload](https://developers.openai.com/api/reference/resources/uploads/methods/complete).
         #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -26,9 +24,15 @@ module OpenAI
         #
         # @overload create(upload_id, data:, request_options: {})
         #
-        # @param upload_id [String] The ID of the Upload.
+        # @param upload_id [String]
+        #   The ID of the Upload.
+        #
+        # @param data [Pathname, StringIO, IO, String, OpenAI::FilePart]
+        #   The chunk of bytes for this Part.
         #
-        # @param data [Pathname, StringIO, IO, String, OpenAI::FilePart] The chunk of bytes for this Part.
+        #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+        #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+        #   content type.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/uploads.rb

@@ -8,42 +8,51 @@ module OpenAI
       # @return [OpenAI::Resources::Uploads::Parts]
       attr_reader :parts
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::UploadCreateParams} for more details.
-      #
       # Creates an intermediate
-      # [Upload](https://platform.openai.com/docs/api-reference/uploads/object) object
+      # [Upload](https://developers.openai.com/api/reference/resources/uploads) object
       # that you can add
-      # [Parts](https://platform.openai.com/docs/api-reference/uploads/part-object) to.
-      # Currently, an Upload can accept at most 8 GB in total and expires after an hour
-      # after you create it.
+      # [Parts](https://developers.openai.com/api/reference/resources/uploads/subresources/parts)
+      # to. Currently, an Upload can accept at most 8 GB in total and expires after an
+      # hour after you create it.
       #
       # Once you complete the Upload, we will create a
-      # [File](https://platform.openai.com/docs/api-reference/files/object) object that
+      # [File](https://developers.openai.com/api/reference/resources/files) object that
       # contains all the parts you uploaded. This File is usable in the rest of our
       # platform as a regular File object.
       #
       # For certain `purpose` values, the correct `mime_type` must be specified. Please
       # refer to documentation for the
-      # [supported MIME types for your use case](https://platform.openai.com/docs/assistants/tools/file-search#supported-files).
+      # [supported MIME types for your use case](https://developers.openai.com/api/docs/guides/tools-file-search#supported-files).
       #
       # For guidance on the proper filename extensions for each purpose, please follow
       # the documentation on
-      # [creating a File](https://platform.openai.com/docs/api-reference/files/create).
+      # [creating a File](https://developers.openai.com/api/reference/resources/files/methods/create).
       #
       # Returns the Upload object with status `pending`.
       #
       # @overload create(bytes:, filename:, mime_type:, purpose:, expires_after: nil, request_options: {})
       #
-      # @param bytes [Integer] The number of bytes in the file you are uploading.
+      # @param bytes [Integer]
+      #   The number of bytes in the file you are uploading.
+      #
+      # @param filename [String]
+      #   The name of the file to upload.
+      #
+      # @param mime_type [String]
+      #   The MIME type of the file.
       #
-      # @param filename [String] The name of the file to upload.
+      #   This must fall within the supported MIME types for your file purpose. See the
+      #   supported MIME types for assistants and vision.
       #
-      # @param mime_type [String] The MIME type of the file.
+      # @param purpose [Symbol, OpenAI::Models::FilePurpose]
+      #   The intended purpose of the uploaded file.
       #
-      # @param purpose [Symbol, OpenAI::Models::FilePurpose] The intended purpose of the uploaded file.
+      #   See the
+      #   [documentation on File purposes](https://developers.openai.com/api/reference/resources/files/methods/create#%28resource%29%20files%20%3E%20%28method%29%20create%20%3E%20%28params%29%200%20%3E%20%28param%29%20purpose%20%3E%20%28schema%29).
       #
-      # @param expires_after [OpenAI::Models::UploadCreateParams::ExpiresAfter] The expiration policy for a file. By default, files with `purpose=batch` expire
+      # @param expires_after [OpenAI::Models::UploadCreateParams::ExpiresAfter]
+      #   The expiration policy for a file. By default, files with `purpose=batch` expire
+      #   after 30 days and all other files are persisted until they are manually deleted.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -62,16 +71,14 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::UploadCancelParams} for more details.
-      #
       # Cancels the Upload. No Parts may be added after an Upload is cancelled.
       #
       # Returns the Upload object with status `cancelled`.
       #
       # @overload cancel(upload_id, request_options: {})
       #
-      # @param upload_id [String] The ID of the Upload.
+      # @param upload_id [String]
+      #   The ID of the Upload.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -88,14 +95,11 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::UploadCompleteParams} for more details.
-      #
       # Completes the
-      # [Upload](https://platform.openai.com/docs/api-reference/uploads/object).
+      # [Upload](https://developers.openai.com/api/reference/resources/uploads).
       #
       # Within the returned Upload object, there is a nested
-      # [File](https://platform.openai.com/docs/api-reference/files/object) object that
+      # [File](https://developers.openai.com/api/reference/resources/files) object that
       # is ready to use in the rest of the platform.
       #
       # You can specify the order of the Parts by passing in an ordered list of the Part
@@ -109,11 +113,15 @@ module OpenAI
       #
       # @overload complete(upload_id, part_ids:, md5: nil, request_options: {})
       #
-      # @param upload_id [String] The ID of the Upload.
+      # @param upload_id [String]
+      #   The ID of the Upload.
       #
-      # @param part_ids [Array<String>] The ordered list of Part IDs.
+      # @param part_ids [Array<String>]
+      #   The ordered list of Part IDs.
       #
-      # @param md5 [String] The optional md5 checksum for the file contents to verify if the bytes uploaded
+      # @param md5 [String]
+      #   The optional md5 checksum for the file contents to verify if the bytes uploaded
+      #   matches what you expect.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/resources/vector_stores/file_batches.rb

@@ -6,22 +6,39 @@ module OpenAI
   module Resources
     class VectorStores
       class FileBatches
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::VectorStores::FileBatchCreateParams} for more details.
-        #
         # Create a vector store file batch.
         #
         # @overload create(vector_store_id, attributes: nil, chunking_strategy: nil, file_ids: nil, files: nil, request_options: {})
         #
-        # @param vector_store_id [String] The ID of the vector store for which to create a File Batch.
-        #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
-        #
-        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
-        #
-        # @param file_ids [Array<String>] A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-        #
-        # @param files [Array<OpenAI::Models::VectorStores::FileBatchCreateParams::File>] A list of objects that each include a `file_id` plus optional `attributes` or `c
+        # @param vector_store_id [String]
+        #   The ID of the vector store for which to create a File Batch.
+        #
+        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+        #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #   for storing additional information about the object in a structured format, and
+        #   querying for objects via API or the dashboard. Keys are strings with a maximum
+        #   length of 64 characters. Values are strings with a maximum length of 512
+        #   characters, booleans, or numbers.
+        #
+        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam]
+        #   The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+        #   strategy. Only applicable if `file_ids` is non-empty.
+        #
+        # @param file_ids [Array<String>]
+        #   A list of [File](https://developers.openai.com/api/reference/resources/files)
+        #   IDs that the vector store should use. Useful for tools like `file_search` that
+        #   can access files. If `attributes` or `chunking_strategy` are provided, they will
+        #   be applied to all files in the batch. The maximum batch size is 2000 files. This
+        #   endpoint is recommended for multi-file ingestion and helps reduce
+        #   per-vector-store write request pressure. Mutually exclusive with `files`.
+        #
+        # @param files [Array<OpenAI::Models::VectorStores::FileBatchCreateParams::File>]
+        #   A list of objects that each include a `file_id` plus optional `attributes` or
+        #   `chunking_strategy`. Use this when you need to override metadata for specific
+        #   files. The global `attributes` or `chunking_strategy` will be ignored and must
+        #   be specified for each file. The maximum batch size is 2000 files. This endpoint
+        #   is recommended for multi-file ingestion and helps reduce per-vector-store write
+        #   request pressure. Mutually exclusive with `file_ids`.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -107,9 +124,11 @@ module OpenAI
         #
         # @overload retrieve(batch_id, vector_store_id:, request_options: {})
         #
-        # @param batch_id [String] The ID of the file batch being retrieved.
+        # @param batch_id [String]
+        #   The ID of the file batch being retrieved.
         #
-        # @param vector_store_id [String] The ID of the vector store that the file batch belongs to.
+        # @param vector_store_id [String]
+        #   The ID of the vector store that the file batch belongs to.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -136,9 +155,11 @@ module OpenAI
         #
         # @overload cancel(batch_id, vector_store_id:, request_options: {})
         #
-        # @param batch_id [String] The ID of the file batch to cancel.
+        # @param batch_id [String]
+        #   The ID of the file batch to cancel.
         #
-        # @param vector_store_id [String] The ID of the vector store that the file batch belongs to.
+        # @param vector_store_id [String]
+        #   The ID of the vector store that the file batch belongs to.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -160,26 +181,39 @@ module OpenAI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::VectorStores::FileBatchListFilesParams} for more details.
-        #
         # Returns a list of vector store files in a batch.
         #
         # @overload list_files(batch_id, vector_store_id:, after: nil, before: nil, filter: nil, limit: nil, order: nil, request_options: {})
         #
-        # @param batch_id [String] Path param: The ID of the file batch that the files belong to.
+        # @param batch_id [String]
+        #   Path param: The ID of the file batch that the files belong to.
         #
-        # @param vector_store_id [String] Path param: The ID of the vector store that the files belong to.
+        # @param vector_store_id [String]
+        #   Path param: The ID of the vector store that the files belong to.
         #
-        # @param after [String] Query param: A cursor for use in pagination. `after` is an object ID that define
+        # @param after [String]
+        #   Query param: 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] Query param: A cursor for use in pagination. `before` is an object ID that defin
+        # @param before [String]
+        #   Query param: 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 filter [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::Filter] Query param: Filter by file status. One of `in_progress`, `completed`, `failed`,
+        # @param filter [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::Filter]
+        #   Query param: Filter by file status. One of `in_progress`, `completed`, `failed`,
+        #   `cancelled`.
         #
-        # @param limit [Integer] Query param: A limit on the number of objects to be returned. Limit can range be
+        # @param limit [Integer]
+        #   Query param: 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::VectorStores::FileBatchListFilesParams::Order] Query param: Sort order by the `created_at` timestamp of the objects. `asc` for
+        # @param order [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::Order]
+        #   Query param: 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]
         #

data/lib/openai/resources/vector_stores/files.rb

@@ -6,22 +6,32 @@ module OpenAI
   module Resources
     class VectorStores
       class Files
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::VectorStores::FileCreateParams} for more details.
-        #
         # Create a vector store file by attaching a
-        # [File](https://platform.openai.com/docs/api-reference/files) to a
-        # [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object).
+        # [File](https://developers.openai.com/api/reference/resources/files) to a
+        # [vector store](https://developers.openai.com/api/reference/resources/vector_stores).
         #
         # @overload create(vector_store_id, file_id:, attributes: nil, chunking_strategy: nil, request_options: {})
         #
-        # @param vector_store_id [String] The ID of the vector store for which to create a File.
+        # @param vector_store_id [String]
+        #   The ID of the vector store for which to create a File.
         #
-        # @param file_id [String] A [File](https://platform.openai.com/docs/api-reference/files) ID that the vecto
+        # @param file_id [String]
+        #   A [File](https://developers.openai.com/api/reference/resources/files) ID that
+        #   the vector store should use. Useful for tools like `file_search` that can access
+        #   files. For multi-file ingestion, we recommend
+        #   [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
+        #   to minimize per-vector-store write requests.
         #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+        #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #   for storing additional information about the object in a structured format, and
+        #   querying for objects via API or the dashboard. Keys are strings with a maximum
+        #   length of 64 characters. Values are strings with a maximum length of 512
+        #   characters, booleans, or numbers.
         #
-        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam]
+        #   The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+        #   strategy. Only applicable if `file_ids` is non-empty.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -102,9 +112,11 @@ module OpenAI
         #
         # @overload retrieve(file_id, vector_store_id:, request_options: {})
         #
-        # @param file_id [String] The ID of the file being retrieved.
+        # @param file_id [String]
+        #   The ID of the file being retrieved.
         #
-        # @param vector_store_id [String] The ID of the vector store that the file belongs to.
+        # @param vector_store_id [String]
+        #   The ID of the vector store that the file belongs to.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -126,18 +138,22 @@ module OpenAI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::VectorStores::FileUpdateParams} for more details.
-        #
         # Update attributes on a vector store file.
         #
         # @overload update(file_id, vector_store_id:, attributes:, request_options: {})
         #
-        # @param file_id [String] Path param: The ID of the file to update attributes.
+        # @param file_id [String]
+        #   Path param: The ID of the file to update attributes.
         #
-        # @param vector_store_id [String] Path param: The ID of the vector store the file belongs to.
+        # @param vector_store_id [String]
+        #   Path param: The ID of the vector store the file belongs to.
         #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Body param: Set of 16 key-value pairs that can be attached to an object. This ca
+        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+        #   Body param: Set of 16 key-value pairs that can be attached to an object. This
+        #   can be useful for storing additional information about the object in a
+        #   structured format, and querying for objects via API or the dashboard. Keys are
+        #   strings with a maximum length of 64 characters. Values are strings with a
+        #   maximum length of 512 characters, booleans, or numbers.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -160,24 +176,35 @@ module OpenAI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::VectorStores::FileListParams} for more details.
-        #
         # Returns a list of vector store files.
         #
         # @overload list(vector_store_id, after: nil, before: nil, filter: nil, limit: nil, order: nil, request_options: {})
         #
-        # @param vector_store_id [String] The ID of the vector store that the files belong to.
+        # @param vector_store_id [String]
+        #   The ID of the vector store that the files belong to.
         #
-        # @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,
+        #   starting with obj_foo, your subsequent call can include before=obj_foo in order
+        #   to fetch the previous page of the list.
         #
-        # @param filter [Symbol, OpenAI::Models::VectorStores::FileListParams::Filter] Filter by file status. One of `in_progress`, `completed`, `failed`, `cancelled`.
+        # @param filter [Symbol, OpenAI::Models::VectorStores::FileListParams::Filter]
+        #   Filter by file status. One of `in_progress`, `completed`, `failed`, `cancelled`.
         #
-        # @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::VectorStores::FileListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+        # @param order [Symbol, OpenAI::Models::VectorStores::FileListParams::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]
         #
@@ -200,14 +227,16 @@ module OpenAI
 
         # Delete a vector store file. This will remove the file from the vector store but
         # the file itself will not be deleted. To delete the file, use the
-        # [delete file](https://platform.openai.com/docs/api-reference/files/delete)
+        # [delete file](https://developers.openai.com/api/reference/resources/files/methods/delete)
         # endpoint.
         #
         # @overload delete(file_id, vector_store_id:, request_options: {})
         #
-        # @param file_id [String] The ID of the file to delete.
+        # @param file_id [String]
+        #   The ID of the file to delete.
         #
-        # @param vector_store_id [String] The ID of the vector store that the file belongs to.
+        # @param vector_store_id [String]
+        #   The ID of the vector store that the file belongs to.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -367,9 +396,11 @@ module OpenAI
         #
         # @overload content(file_id, vector_store_id:, request_options: {})
         #
-        # @param file_id [String] The ID of the file within the vector store.
+        # @param file_id [String]
+        #   The ID of the file within the vector store.
         #
-        # @param vector_store_id [String] The ID of the vector store.
+        # @param vector_store_id [String]
+        #   The ID of the vector store.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #