openai 0.87.0 → 0.89.0

data/lib/openai/models/uploads/part_create_params.rb

@@ -24,12 +24,14 @@ module OpenAI
         required :data, OpenAI::Internal::Type::FileInput
 
         # @!method initialize(upload_id:, data:, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Uploads::PartCreateParams} for more details.
-        #
         #   @param upload_id [String]
         #
-        #   @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}]
       end

data/lib/openai/models/uploads/upload_part.rb

@@ -32,13 +32,17 @@ module OpenAI
         # @!method initialize(id:, created_at:, upload_id:, object: :"upload.part")
         #   The upload Part represents a chunk of bytes we can add to an Upload object.
         #
-        #   @param id [String] The upload Part unique identifier, which can be referenced in API endpoints.
+        #   @param id [String]
+        #     The upload Part unique identifier, which can be referenced in API endpoints.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) for when the Part was created.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) for when the Part was created.
         #
-        #   @param upload_id [String] The ID of the Upload object that this Part was added to.
+        #   @param upload_id [String]
+        #     The ID of the Upload object that this Part was added to.
         #
-        #   @param object [Symbol, :"upload.part"] The object type, which is always `upload.part`.
+        #   @param object [Symbol, :"upload.part"]
+        #     The object type, which is always `upload.part`.
       end
     end
 

data/lib/openai/models/vector_store.rb

@@ -77,33 +77,47 @@ module OpenAI
       optional :expires_at, Integer, nil?: true
 
       # @!method initialize(id:, created_at:, file_counts:, last_active_at:, metadata:, name:, status:, usage_bytes:, expires_after: nil, expires_at: nil, object: :vector_store)
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::VectorStore} for more details.
-      #
       #   A vector store is a collection of processed files can be used by the
       #   `file_search` tool.
       #
-      #   @param id [String] The identifier, which can be referenced in API endpoints.
+      #   @param id [String]
+      #     The identifier, which can be referenced in API endpoints.
       #
-      #   @param created_at [Integer] The Unix timestamp (in seconds) for when the vector store was created.
+      #   @param created_at [Integer]
+      #     The Unix timestamp (in seconds) for when the vector store was created.
       #
       #   @param file_counts [OpenAI::Models::VectorStore::FileCounts]
       #
-      #   @param last_active_at [Integer, nil] The Unix timestamp (in seconds) for when the vector store was last active.
+      #   @param last_active_at [Integer, nil]
+      #     The Unix timestamp (in seconds) for when the vector store was last active.
+      #
+      #   @param metadata [Hash{Symbol=>String}, 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.
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      #     Keys are strings with a maximum length of 64 characters. Values are strings with
+      #     a maximum length of 512 characters.
       #
-      #   @param name [String] The name of the vector store.
+      #   @param name [String]
+      #     The name of the vector store.
       #
-      #   @param status [Symbol, OpenAI::Models::VectorStore::Status] The status of the vector store, which can be either `expired`, `in_progress`, or
+      #   @param status [Symbol, OpenAI::Models::VectorStore::Status]
+      #     The status of the vector store, which can be either `expired`, `in_progress`, or
+      #     `completed`. A status of `completed` indicates that the vector store is ready
+      #     for use.
       #
-      #   @param usage_bytes [Integer] The total number of bytes used by the files in the vector store.
+      #   @param usage_bytes [Integer]
+      #     The total number of bytes used by the files in the vector store.
       #
-      #   @param expires_after [OpenAI::Models::VectorStore::ExpiresAfter] The expiration policy for a vector store.
+      #   @param expires_after [OpenAI::Models::VectorStore::ExpiresAfter]
+      #     The expiration policy for a vector store.
       #
-      #   @param expires_at [Integer, nil] The Unix timestamp (in seconds) for when the vector store will expire.
+      #   @param expires_at [Integer, nil]
+      #     The Unix timestamp (in seconds) for when the vector store will expire.
       #
-      #   @param object [Symbol, :vector_store] The object type, which is always `vector_store`.
+      #   @param object [Symbol, :vector_store]
+      #     The object type, which is always `vector_store`.
 
       # @see OpenAI::Models::VectorStore#file_counts
       class FileCounts < OpenAI::Internal::Type::BaseModel
@@ -138,15 +152,20 @@ module OpenAI
         required :total, Integer
 
         # @!method initialize(cancelled:, completed:, failed:, in_progress:, total:)
-        #   @param cancelled [Integer] The number of files that were cancelled.
+        #   @param cancelled [Integer]
+        #     The number of files that were cancelled.
         #
-        #   @param completed [Integer] The number of files that have been successfully processed.
+        #   @param completed [Integer]
+        #     The number of files that have been successfully processed.
         #
-        #   @param failed [Integer] The number of files that have failed to process.
+        #   @param failed [Integer]
+        #     The number of files that have failed to process.
         #
-        #   @param in_progress [Integer] The number of files that are currently being processed.
+        #   @param in_progress [Integer]
+        #     The number of files that are currently being processed.
         #
-        #   @param total [Integer] The total number of files.
+        #   @param total [Integer]
+        #     The total number of files.
       end
 
       # The status of the vector store, which can be either `expired`, `in_progress`, or
@@ -181,14 +200,14 @@ module OpenAI
         required :days, Integer
 
         # @!method initialize(days:, anchor: :last_active_at)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStore::ExpiresAfter} for more details.
-        #
         #   The expiration policy for a vector store.
         #
-        #   @param days [Integer] The number of days after the anchor time that the vector store will expire.
+        #   @param days [Integer]
+        #     The number of days after the anchor time that the vector store will expire.
         #
-        #   @param anchor [Symbol, :last_active_at] Anchor timestamp after which the expiration policy applies. Supported anchors: `
+        #   @param anchor [Symbol, :last_active_at]
+        #     Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #     `last_active_at`.
       end
     end
   end

data/lib/openai/models/vector_store_create_params.rb

@@ -28,9 +28,9 @@ module OpenAI
       optional :expires_after, -> { OpenAI::VectorStoreCreateParams::ExpiresAfter }
 
       # @!attribute file_ids
-      #   A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-      #   the vector store should use. Useful for tools like `file_search` that can access
-      #   files.
+      #   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.
       #
       #   @return [Array<String>, nil]
       optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
@@ -53,20 +53,32 @@ module OpenAI
       optional :name, String
 
       # @!method initialize(chunking_strategy: nil, description: nil, expires_after: nil, file_ids: nil, metadata: nil, name: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::VectorStoreCreateParams} for more details.
+      #   @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 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 description [String]
+      #     A description for the vector store. Can be used to describe the vector store's
+      #     purpose.
       #
-      #   @param description [String] A description for the vector store. Can be used to describe the vector store's p
+      #   @param expires_after [OpenAI::Models::VectorStoreCreateParams::ExpiresAfter]
+      #     The expiration policy for a vector store.
       #
-      #   @param expires_after [OpenAI::Models::VectorStoreCreateParams::ExpiresAfter] The expiration policy for a vector store.
+      #   @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.
       #
-      #   @param file_ids [Array<String>] A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
+      #   @param metadata [Hash{Symbol=>String}, 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.
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      #     Keys are strings with a maximum length of 64 characters. Values are strings with
+      #     a maximum length of 512 characters.
       #
-      #   @param name [String] The name of the vector store.
+      #   @param name [String]
+      #     The name of the vector store.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -85,14 +97,14 @@ module OpenAI
         required :days, Integer
 
         # @!method initialize(days:, anchor: :last_active_at)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStoreCreateParams::ExpiresAfter} for more details.
-        #
         #   The expiration policy for a vector store.
         #
-        #   @param days [Integer] The number of days after the anchor time that the vector store will expire.
+        #   @param days [Integer]
+        #     The number of days after the anchor time that the vector store will expire.
         #
-        #   @param anchor [Symbol, :last_active_at] Anchor timestamp after which the expiration policy applies. Supported anchors: `
+        #   @param anchor [Symbol, :last_active_at]
+        #     Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #     `last_active_at`.
       end
     end
   end

data/lib/openai/models/vector_store_list_params.rb

@@ -40,16 +40,25 @@ module OpenAI
       optional :order, enum: -> { OpenAI::VectorStoreListParams::Order }
 
       # @!method initialize(after: nil, before: nil, limit: nil, order: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::VectorStoreListParams} for more details.
+      #   @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 after [String] A cursor for use in pagination. `after` is an object ID that defines your place
+      #   @param before [String]
+      #     A cursor for use in pagination. `before` is an object ID that defines your place
+      #     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 before [String] A cursor for use in pagination. `before` is an object ID that defines your place
+      #   @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 limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
-      #
-      #   @param order [Symbol, OpenAI::Models::VectorStoreListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+      #   @param order [Symbol, OpenAI::Models::VectorStoreListParams::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}]
 

data/lib/openai/models/vector_store_search_params.rb

@@ -44,20 +44,23 @@ module OpenAI
       optional :rewrite_query, OpenAI::Internal::Type::Boolean
 
       # @!method initialize(vector_store_id:, query:, filters: nil, max_num_results: nil, ranking_options: nil, rewrite_query: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::VectorStoreSearchParams} for more details.
-      #
       #   @param vector_store_id [String]
       #
-      #   @param query [String, Array<String>] A query string for a search
+      #   @param query [String, Array<String>]
+      #     A query string for a search
       #
-      #   @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter] A filter to apply based on file attributes.
+      #   @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter]
+      #     A filter to apply based on file attributes.
       #
-      #   @param max_num_results [Integer] The maximum number of results to return. This number should be between 1 and 50
+      #   @param max_num_results [Integer]
+      #     The maximum number of results to return. This number should be between 1 and 50
+      #     inclusive.
       #
-      #   @param ranking_options [OpenAI::Models::VectorStoreSearchParams::RankingOptions] Ranking options for search.
+      #   @param ranking_options [OpenAI::Models::VectorStoreSearchParams::RankingOptions]
+      #     Ranking options for search.
       #
-      #   @param rewrite_query [Boolean] Whether to rewrite the natural language query for vector search.
+      #   @param rewrite_query [Boolean]
+      #     Whether to rewrite the natural language query for vector search.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -105,7 +108,8 @@ module OpenAI
         # @!method initialize(ranker: nil, score_threshold: nil)
         #   Ranking options for search.
         #
-        #   @param ranker [Symbol, OpenAI::Models::VectorStoreSearchParams::RankingOptions::Ranker] Enable re-ranking; set to `none` to disable, which can help reduce latency.
+        #   @param ranker [Symbol, OpenAI::Models::VectorStoreSearchParams::RankingOptions::Ranker]
+        #     Enable re-ranking; set to `none` to disable, which can help reduce latency.
         #
         #   @param score_threshold [Float]
 

data/lib/openai/models/vector_store_search_response.rb

@@ -46,19 +46,24 @@ module OpenAI
       required :score, Float
 
       # @!method initialize(attributes:, content:, file_id:, filename:, score:)
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::VectorStoreSearchResponse} for more details.
+      #   @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 attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      #   @param content [Array<OpenAI::Models::VectorStoreSearchResponse::Content>]
+      #     Content chunks from the file.
       #
-      #   @param content [Array<OpenAI::Models::VectorStoreSearchResponse::Content>] Content chunks from the file.
+      #   @param file_id [String]
+      #     The ID of the vector store file.
       #
-      #   @param file_id [String] The ID of the vector store file.
+      #   @param filename [String]
+      #     The name of the vector store file.
       #
-      #   @param filename [String] The name of the vector store file.
-      #
-      #   @param score [Float] The similarity score for the result.
-
+      #   @param score [Float]
+      #     The similarity score for the result.
       module Attribute
         extend OpenAI::Internal::Type::Union
 
@@ -86,9 +91,11 @@ module OpenAI
         required :type, enum: -> { OpenAI::Models::VectorStoreSearchResponse::Content::Type }
 
         # @!method initialize(text:, type:)
-        #   @param text [String] The text content returned from search.
+        #   @param text [String]
+        #     The text content returned from search.
         #
-        #   @param type [Symbol, OpenAI::Models::VectorStoreSearchResponse::Content::Type] The type of content.
+        #   @param type [Symbol, OpenAI::Models::VectorStoreSearchResponse::Content::Type]
+        #     The type of content.
 
         # The type of content.
         #

data/lib/openai/models/vector_store_update_params.rb

@@ -36,16 +36,21 @@ module OpenAI
       optional :name, String, nil?: true
 
       # @!method initialize(vector_store_id:, expires_after: nil, metadata: nil, name: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::VectorStoreUpdateParams} for more details.
-      #
       #   @param vector_store_id [String]
       #
-      #   @param expires_after [OpenAI::Models::VectorStoreUpdateParams::ExpiresAfter, nil] The expiration policy for a vector store.
+      #   @param expires_after [OpenAI::Models::VectorStoreUpdateParams::ExpiresAfter, nil]
+      #     The expiration policy for a vector store.
+      #
+      #   @param metadata [Hash{Symbol=>String}, 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.
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      #     Keys are strings with a maximum length of 64 characters. Values are strings with
+      #     a maximum length of 512 characters.
       #
-      #   @param name [String, nil] The name of the vector store.
+      #   @param name [String, nil]
+      #     The name of the vector store.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -64,14 +69,14 @@ module OpenAI
         required :days, Integer
 
         # @!method initialize(days:, anchor: :last_active_at)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStoreUpdateParams::ExpiresAfter} for more details.
-        #
         #   The expiration policy for a vector store.
         #
-        #   @param days [Integer] The number of days after the anchor time that the vector store will expire.
+        #   @param days [Integer]
+        #     The number of days after the anchor time that the vector store will expire.
         #
-        #   @param anchor [Symbol, :last_active_at] Anchor timestamp after which the expiration policy applies. Supported anchors: `
+        #   @param anchor [Symbol, :last_active_at]
+        #     Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #     `last_active_at`.
       end
     end
   end

data/lib/openai/models/vector_stores/file_batch_create_params.rb

@@ -37,12 +37,12 @@ module OpenAI
         optional :chunking_strategy, union: -> { OpenAI::FileChunkingStrategyParam }
 
         # @!attribute file_ids
-        #   A list of [File](https://platform.openai.com/docs/api-reference/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`.
+        #   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`.
         #
         #   @return [Array<String>, nil]
         optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
@@ -59,18 +59,34 @@ module OpenAI
         optional :files, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::VectorStores::FileBatchCreateParams::File] }
 
         # @!method initialize(vector_store_id:, attributes: nil, chunking_strategy: nil, file_ids: nil, files: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileBatchCreateParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
-        #   @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 file_ids [Array<String>] A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
+        #   @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 `c
+        #   @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}]
 
@@ -89,10 +105,10 @@ module OpenAI
 
         class File < OpenAI::Internal::Type::BaseModel
           # @!attribute file_id
-          #   A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-          #   vector store should use. Useful for tools like `file_search` that can access
+          #   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://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          #   [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
           #   to minimize per-vector-store write requests.
           #
           #   @return [String]
@@ -122,15 +138,23 @@ module OpenAI
           optional :chunking_strategy, union: -> { OpenAI::FileChunkingStrategyParam }
 
           # @!method initialize(file_id:, attributes: nil, chunking_strategy: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::VectorStores::FileBatchCreateParams::File} for more details.
+          #   @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 file_id [String] A [File](https://platform.openai.com/docs/api-reference/files) ID that the vecto
+          #   @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 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 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.
           module Attribute
             extend OpenAI::Internal::Type::Union
 

data/lib/openai/models/vector_stores/file_batch_list_files_params.rb

@@ -57,22 +57,32 @@ module OpenAI
         optional :order, enum: -> { OpenAI::VectorStores::FileBatchListFilesParams::Order }
 
         # @!method initialize(vector_store_id:, batch_id:, after: nil, before: nil, filter: nil, limit: nil, order: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileBatchListFilesParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
         #   @param batch_id [String]
         #
-        #   @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::FileBatchListFilesParams::Filter] Filter by file status. One of `in_progress`, `completed`, `failed`, `cancelled`.
+        #   @param filter [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::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::FileBatchListFilesParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+        #   @param order [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::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}]
 

data/lib/openai/models/vector_stores/file_content_response.rb

@@ -18,9 +18,11 @@ module OpenAI
         optional :type, String
 
         # @!method initialize(text: nil, type: nil)
-        #   @param text [String] The text content
+        #   @param text [String]
+        #     The text content
         #
-        #   @param type [String] The content type (currently only `"text"`)
+        #   @param type [String]
+        #     The content type (currently only `"text"`)
       end
     end
   end

data/lib/openai/models/vector_stores/file_create_params.rb

@@ -14,10 +14,10 @@ module OpenAI
         required :vector_store_id, String
 
         # @!attribute file_id
-        #   A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-        #   vector store should use. Useful for tools like `file_search` that can access
+        #   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://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+        #   [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
         #   to minimize per-vector-store write requests.
         #
         #   @return [String]
@@ -47,16 +47,25 @@ module OpenAI
         optional :chunking_strategy, union: -> { OpenAI::FileChunkingStrategyParam }
 
         # @!method initialize(vector_store_id:, file_id:, attributes: nil, chunking_strategy: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileCreateParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
-        #   @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}]