API reference
Agents API
Agent definitions and Invoke. An Idempotency-Key header makes a repeated Invoke return the existing Agent run.
Access. Signed-in caller or PAT. Reads follow Mode; Invoke needs write, because it spends tokens. Public Agents are never invokable anonymously.
OpenAPI tag Agents. Paths are relative to the API host.
| Method | Path | Operation |
|---|---|---|
| GET | /api/v1/agents | List agents |
| POST | /api/v1/agents | Create an agent |
| GET | /api/v1/agents/{id} | Get an agent |
| PUT | /api/v1/agents/{id} | Update an agent |
| DELETE | /api/v1/agents/{id} | Delete an agent |
| POST | /api/v1/agents/{id}/invoke | Invoke an agent |