Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Create, update, and delete agents with the OneCLI API. Manage gateway access tokens, hosted agent models, avatars, conversations, and SSH access.
| Endpoint | Method and path | What it does |
|---|---|---|
| List agents | GET /agents | List every agent in your workspace, newest first, with its gateway access token. |
| Create an agent | POST /agents | Create an agent in your workspace, either one you run yourself through the gateway or a hosted agent. |
| Get an agent | GET /agents/{agentId} | Get one agent with its hosted configuration, such as harness, model, and instructions. |
| Update an agent | PATCH /agents/{agentId} | Rename an agent, or change a hosted agent’s brief and model override. |
| Delete an agent | DELETE /agents/{agentId} | Delete an agent with its grants, conversations, schedules, memories, and channel presences. |
| Regenerate an agent’s access token | POST /agents/{agentId}/regenerate-token | Mint a new gateway access token for an agent and invalidate the old one. |
| Restart a hosted agent | POST /agents/{agentId}/restart | Restart a hosted agent. |
| List an agent’s available models | GET /agents/{agentId}/models | List the models an agent’s granted LLM key can run, the provider defaults, and the agent’s current selection. |
| Upload an agent’s avatar | PUT /agents/{agentId}/image | Upload an agent’s avatar as raw PNG, JPEG, GIF, or WebP bytes up to 1 MB. |
| Remove an agent’s avatar | DELETE /agents/{agentId}/image | Remove an agent’s avatar and return it to the default mark. |
| Open your direct conversation with an agent | PUT /agents/{agentId}/conversations/direct | Open your private direct conversation with an agent, creating it on the first call. |
| Mint an SSH certificate for an agent | POST /agents/{agentId}/ssh-certificate | Sign a short-lived OpenSSH user certificate to SSH into a hosted agent’s sandbox, using an inline ed25519 key or a registered key. |
