Runs
A run is one execution of a teammate or task. Use runs for direct messages, follow-ups, and real-time output.
Create a run
Streaming (default and recommended)
Use the context manager so the stream closes cleanly even if you exit early.
Python
Direct iteration is still supported:
Python
Stream text only
Python
Non-streaming
Follow up on a run
Follow-up messages create a new run that keeps context from the previous one.
Python
runs.reply() is always non-interactive. It does not enable AskUserQuestion, approval mode, or plan mode.
Run options
For permission and approval flows, see Human-in-the-Loop.
Run statuses
Run files
Runs can generate files. List and download them after execution.
Python
What's next
- Teammates for trigger setup and teammate configuration
- Tasks for reusable work definitions
- Streaming & Events for full event taxonomy
- Webhook Events for outbound run notifications