Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
List, create, rename, and delete workspaces with the OneCLI API. Each workspace keeps its own agents, secrets, and app connections apart from the rest.
X-Workspace-Id header when you call with an organization key.
Use these endpoints to provision workspaces from scripts or CI. To share a workspace with people and groups, use the Workspace access endpoints. For the concepts behind workspaces, see Projects.
| Endpoint | Method and path | What it does |
|---|---|---|
| List workspaces | GET /workspaces | List the workspaces you can see in your organization. |
| Create a workspace | POST /workspaces | Create a new workspace in your organization. |
| Get a workspace | GET /workspaces/{workspaceId} | Get one workspace by id. |
| Rename a workspace | PATCH /workspaces/{workspaceId} | Rename a workspace. |
| Delete a workspace | DELETE /workspaces/{workspaceId} | Delete a workspace and everything in it, including its agents, secrets, connections, and conversations. |
| List pending channel approvals | GET /workspaces/{workspaceId}/channel-approvals | List every pending action approval and reach ask across a workspace’s hosted agents, oldest first. |