diff --git a/.speakeasy/in.openapi.yaml b/.speakeasy/in.openapi.yaml
index ceb2a43f..e33115f9 100644
--- a/.speakeasy/in.openapi.yaml
+++ b/.speakeasy/in.openapi.yaml
@@ -21635,6 +21635,7 @@ components:
         latency_last_30m:
           $ref: '#/components/schemas/PercentileStats'
         max_completion_tokens:
+          description: 'Maximum completion tokens for this endpoint. Input and output tokens share the context window, so the effective maximum output for a request is further limited by the context remaining after input tokens.'
           type:
             - 'integer'
             - 'null'
@@ -24616,7 +24617,7 @@ components:
           example: true
           type: 'boolean'
         max_completion_tokens:
-          description: 'Maximum completion tokens from the top provider'
+          description: 'Maximum completion tokens from the top provider. Input and output tokens share the context window, so the effective maximum output for a request is further limited by the context remaining after input tokens.'
           example: 4096
           type:
             - 'integer'