From 55cb510eed460249da8dcd070eec236de4e871b5 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 15 Sep 2025 19:52:07 +0000
Subject: [PATCH] chore(api): docs and spec refactoring

---
 .stats.yml                    | 6 +++---
 chatcompletion.go             | 7 +++++--
 conversations/conversation.go | 8 ++++++--
 3 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index b09c447..1cf4c43 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 106
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-94b1e3cb0bdc616ff0c2f267c33dadd95f133b1f64e647aab6c64afb292b2793.yml
-openapi_spec_hash: 2395319ac9befd59b6536ae7f9564a05
-config_hash: 930dac3aa861344867e4ac84f037b5df
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-d30ff992a48873c1466c49f3c01f2ec8933faebff23424748f8d056065b1bcef.yml
+openapi_spec_hash: e933ec43b46f45c348adb78840e5808d
+config_hash: bf45940f0a7805b4ec2017eecdd36893
diff --git a/chatcompletion.go b/chatcompletion.go
index 7d2a658..f07c16d 100644
--- a/chatcompletion.go
+++ b/chatcompletion.go
@@ -3395,9 +3395,12 @@ type ChatCompletionListParams struct {
 	Limit param.Opt[int64] `query:"limit,omitzero" json:"-"`
 	// The model used to generate the Chat Completions.
 	Model param.Opt[string] `query:"model,omitzero" json:"-"`
-	// A list of metadata keys to filter the Chat Completions by. Example:
+	// 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.
 	//
-	// `metadata[key1]=value1&metadata[key2]=value2`
+	// Keys are strings with a maximum length of 64 characters. Values are strings with
+	// a maximum length of 512 characters.
 	Metadata shared.Metadata `query:"metadata,omitzero" json:"-"`
 	// Sort order for Chat Completions by timestamp. Use `asc` for ascending order or
 	// `desc` for descending order. Defaults to `asc`.
diff --git a/conversations/conversation.go b/conversations/conversation.go
index b4b5470..c6b4ce3 100644
--- a/conversations/conversation.go
+++ b/conversations/conversation.go
@@ -750,8 +750,12 @@ type ConversationNewParams struct {
 	// Initial items to include in the conversation context. You may add up to 20 items
 	// at a time.
 	Items []responses.ResponseInputItemUnionParam `json:"items,omitzero"`
-	// Set of 16 key-value pairs that can be attached to an object. Useful for storing
-	// additional information about the object in a structured format.
+	// 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.
 	Metadata shared.Metadata `json:"metadata,omitzero"`
 	paramObj
 }