Workers explained
Your workers. Voice or chat agents you hire and assign to jobs.
A worker is an agent with a type (voice or chat), a model, instructions and tools. In the dashboard it lives under Workforce. In the API it's still called an agent in the paths. Same thing.
Two endpoints families:
| Path | Use it for | |
|---|---|---|
| Current | GET /v2/agents | Everything the Workforce page shows. Assigned jobs, reliability, status. |
| Older | /v1/agents | Create, read, update, deactivate. Instructions and tools. |
You will probably use both. /v2 to look, /v1 to change.
Status values
active, inactive, training, deployed. Only active (and training for chat) workers accept conversations.
Types
| Type | Talks over | Default model |
|---|---|---|
voice | phone | gpt-realtime-2.1 |
chat | widget, API | gpt-5.6-terra |
Type is fixed at creation. Make a new worker if you need the other one.