> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces API: Partition Agents, Secrets, and Apps

> List, create, rename, and delete workspaces with the Buckle API. Each workspace keeps its own agents, secrets, and app connections apart from the rest.

A workspace partitions an organization's agents, secrets, and connections. Every workspace-scoped endpoint resolves its workspace from the API key, or from the `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](/docs/api-reference/workspace-access) endpoints. For the concepts behind workspaces, see [Projects](/docs/guides/projects.md).

## Related guides

* [Projects: organize agents into workspaces](/docs/guides/projects.md)
* [User provisioning: give people access](/docs/guides/user-provisioning.md)

## Endpoints

| Endpoint | Method and path | What it does |
| - | - | - |
| [List workspaces](/docs/api-reference/workspaces/list-workspaces.md) | `GET /workspaces` | List the workspaces you can see in your organization. |
| [Create a workspace](/docs/api-reference/workspaces/create-a-workspace.md) | `POST /workspaces` | Create a new workspace in your organization. |
| [Get a workspace](/docs/api-reference/workspaces/get-a-workspace.md) | `GET /workspaces/{workspaceId}` | Get one workspace by id. |
| [Rename a workspace](/docs/api-reference/workspaces/rename-a-workspace.md) | `PATCH /workspaces/{workspaceId}` | Rename a workspace. |
| [Delete a workspace](/docs/api-reference/workspaces/delete-a-workspace.md) | `DELETE /workspaces/{workspaceId}` | Delete a workspace and everything in it, including its agents, secrets, connections, and conversations. |
| [List pending channel approvals](/docs/api-reference/workspaces/list-pending-channel-approvals.md) | `GET /workspaces/{workspaceId}/channel-approvals` | List every pending action approval and reach ask across a workspace's hosted agents, oldest first. |

## Next steps

* [API overview](/docs/api-reference.md): base URLs, authentication, and pagination
* [Errors](/docs/api-reference/errors.md): status codes and the error format
* [Editions](/docs/api-reference/editions.md): which endpoints each edition serves


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.