python example, param

Author: aahill

articles/ai-services/openai/assistants-reference-runs.md

@@ -259,10 +259,30 @@ curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}/runs
 
 ## Retrieve run
 
+# [Python 1.x](#tab/python)
+
+```python
+from openai import OpenAI
+client = OpenAI()
+
+run = client.beta.threads.runs.retrieve(
+  thread_id="thread_abc123",
+  run_id="run_abc123"
+)
+
+print(run)
+```
+
+# [REST](#tab/rest)
+
 ```http
-GET https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}/runs/{run_id}?api-version=2024-05-01-preview
+curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}/runs/{run_id}?api-version=2024-05-01-preview
+  -H "api-key: $AZURE_OPENAI_API_KEY" \
+  -H 'Content-Type: application/json' 
 ```
 
+---
+
 Retrieves a run.
 
 **Path parameters**
@@ -565,6 +585,7 @@ Represents an execution run on a thread.
 | `tool_choice` | string or object | Controls which (if any) tool is called by the model. `none` means the model won't call any tools and instead generates a message. `auto` is the default value and means the model can pick between generating a message or calling a tool. Specifying a particular tool like `{"type": "file_search"}` or `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that tool. |
 | `max_prompt_tokens` | integer or null | The maximum number of prompt tokens specified to have been used over the course of the run. |
 | `max_completion_tokens` | integer or null | The maximum number of completion tokens specified to have been used over the course of the run. |
+| `usage` | object or null | Usage statistics related to the run. This value will be null if the run is not in a terminal state (for example `in_progress`, `queued`). |
 
 
 ## Run step object