@@ -31,8 +31,7 @@ Start with the most common issue for your symptoms:
     format problems
   </Card>
   <Card title="Parameters cut off" href="#token-truncation">
-    **Symptoms:** Tool parameters or responses truncated Increase the model
-    token limit
+    **Symptoms:** Tool parameters or responses are truncated.
   </Card>
 </CardGroup>
 
@@ -77,14 +76,17 @@ Check that your tool schema includes all required parameters:
 
 Add `strict: true` to catch validation errors early:
 
-```json title="Tool configuration" {7}
+```json title="Tool configuration" {9}
 {
-  "name": "get_weather",
-  "description": "Get current weather for a city",
-  "parameters": {
-    // ... your parameters
-  },
-  "strict": true
+  "type": "function",
+  "function": {
+    "name": "get_weather",
+    "description": "Get current weather for a city",
+    "parameters": {
+      // ... your parameters
+    },
+    "strict": true
+  }
 }
 ```
 
@@ -228,8 +230,9 @@ Tool parameters or responses are getting cut off.
 ### Increase the model token limit
 
 Tool call arguments are generated by the model, so they draw on the same
-per-turn token budget as speech. Raise `maxTokens` on the assistant's `model`,
-not on the tool. It accepts a value from `50` to `10000` and defaults to `250`.
+per-turn token budget as speech. Raise [`maxTokens` on the assistant's `model`](/api-reference/assistants/create#request.body.model),
+not on the tool. It accepts a value from `50` to `10000`. When unset, the model
+applies its own default (currently `250`).
 
 <Warning>
   `maxTokens` is a model property, not a tool property. Setting it inside