From 1cabcb09699547181598d8653446f4c0f454a409 Mon Sep 17 00:00:00 2001
From: markstuart-oai <323302876+markstuart-oai@users.noreply.github.com>
Date: Fri, 25 Sep 2026 18:00:07 +0000
Subject: [PATCH] chore(api): document stored chat completion errors

Castiron-Internal-PR: https://github.com/openai/openai-ruby-internal/pull/157
Castiron-Source-SHA: 0df643321507f0987973de89a5cb71da58735164
Castiron-Public-Base-SHA: 0185fa1c637f1dbc9d3b3fa85c4c46a199702188
---
 .castiron.stats.yml                   | 10 ++--
 api_reference/openapi.transformed.yml | 82 +++++++++++++++++++++++++++
 2 files changed, 87 insertions(+), 5 deletions(-)

diff --git a/.castiron.stats.yml b/.castiron.stats.yml
index 50efda6c7..0b1e1b2ba 100644
--- a/.castiron.stats.yml
+++ b/.castiron.stats.yml
@@ -1,8 +1,8 @@
 schema_version: 1
-generation_id: fef46aaf-0401-45c5-a9b9-a206bad97565
-openapi_spec_hash: 0ec6a7e693cd01f26722c3dab19fc122
-openapi_transformed_spec_hash: f0b54f1f631dbd006b7768595bcda2d4
+generation_id: 2a40c387-110b-4115-b204-58be4c2d5a98
+openapi_spec_hash: 51a93abe82b6f71bdb437dd6a5cb1073
+openapi_transformed_spec_hash: 6e1ff6e06165d5b2e49cbfd336f00c20
 config_hash: 84cdcc959ee7140cc9a65e9b642c097b
-codegen_sha: d728f53ac71cf3246bedce0fa23dae1834b15498
+codegen_sha: f5e6cad2ee60eaf02a71f587046e4176356d8f35
 codegen_hash: f3176be1e32fe783aafc70df5d9528549e706c1abba10938130775dfb0e462ab
-public_codegen_sha: b54aa8efbf40168492b6bf1b7cc8cfa7c8935133
+public_codegen_sha: c228885a916d40fb2e818a60de8aad64c442a6ee
diff --git a/api_reference/openapi.transformed.yml b/api_reference/openapi.transformed.yml
index fc9cfaa65..081953a77 100644
--- a/api_reference/openapi.transformed.yml
+++ b/api_reference/openapi.transformed.yml
@@ -1995,6 +1995,20 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/ChatCompletionList'
+        '400':
+          description: Invalid pagination or filter parameters.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequests'
+        '500':
+          description: An internal error prevented the request from being completed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
       x-oaiMeta:
         group: chat
         path: list
@@ -2924,6 +2938,20 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/CreateChatCompletionResponse'
+        '404':
+          description: No stored chat completion was found with the specified ID.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequests'
+        '500':
+          description: An internal error prevented the request from being completed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
       x-oaiMeta:
         group: chat
         examples:
@@ -3012,6 +3040,26 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/CreateChatCompletionResponse'
+        '400':
+          description: Invalid metadata update.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: No stored chat completion was found with the specified ID.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequests'
+        '500':
+          description: An internal error prevented the request from being completed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
       x-oaiMeta:
         group: chat
         examples:
@@ -3091,6 +3139,20 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/ChatCompletionDeleted'
+        '404':
+          description: No stored chat completion was found with the specified ID.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequests'
+        '500':
+          description: An internal error prevented the request from being completed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
       x-oaiMeta:
         group: chat
         examples:
@@ -3160,6 +3222,26 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/ChatCompletionMessageList'
+        '400':
+          description: Invalid message pagination parameters.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: No stored chat completion was found with the specified ID.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequests'
+        '500':
+          description: An internal error prevented the request from being completed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
       x-oaiMeta:
         group: chat
         examples: