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

# Manage overview

> Create and administer the containers your agents live in: workspaces that group projects and people, and projects that each own a single agent.

Workspaces group projects and the people who can reach them. A project owns a
single agent and everything inside it.

These endpoints create and administer both, and they are where you get the
`projectID` that almost every other endpoint in this API asks for.

## Endpoints

### Project

| Endpoint | Description |
| - | - |
| GET [List projects](https://www.voiceflow.com/docs/api-reference/project/list-projects.md) | List all projects by workspace ID. |
| POST [Create project](https://www.voiceflow.com/docs/api-reference/project/create-project.md) | Create a new project. |
| GET [Get project](https://www.voiceflow.com/docs/api-reference/project/get-project.md) | Get a project by ID. |
| PATCH [Update project](https://www.voiceflow.com/docs/api-reference/project/update-project.md) | Update a project by ID. |
| DELETE [Delete project](https://www.voiceflow.com/docs/api-reference/project/delete-project.md) | Delete a project by ID. |

### Workspace

| Endpoint | Description |
| - | - |
| GET [List workspaces](https://www.voiceflow.com/docs/api-reference/workspace/list-workspaces.md) | List all workspaces the authorized account is a member of. |
| POST [Create workspace](https://www.voiceflow.com/docs/api-reference/workspace/create-workspace.md) | Create a new workspace. |
| GET [Get workspace](https://www.voiceflow.com/docs/api-reference/workspace/get-workspace.md) | Get a single workspace by ID. |
| PATCH [Update workspace](https://www.voiceflow.com/docs/api-reference/workspace/update-workspace.md) | Update a single workspace by ID. |
| DELETE [Delete workspace](https://www.voiceflow.com/docs/api-reference/workspace/delete-workspace.md) | Delete a single workspace by ID. |

## The hierarchy

An organization contains **workspaces**. A workspace contains **projects**. A
project owns exactly one agent, along with its playbooks, tools, variables,
knowledge base and environments.

Most other endpoints in this API take a `projectID`, which you get by listing
the projects in a workspace:

```bash theme={null}
curl "https://realtime-api.voiceflow.com/v1/stable/project?workspaceID=$VF_WORKSPACE_ID" \
  -H "Authorization: Bearer $VF_PAT"
```

## What a token can see

A [personal access token](https://www.voiceflow.com/docs/api-reference/authentication.md) carries your own
access. Listing workspaces returns every workspace your account belongs to, not
a subset scoped to the integration, so a script that iterates workspaces will
reach further than you might expect. Pin the IDs you mean to operate on rather
than discovering them at runtime.

## Deleting

Deleting a project removes the agent and everything in it, including
transcripts. Deleting a workspace removes every project inside it. Neither is
recoverable through the API.

## Where to go next

With a project in hand, [build its agent](https://www.voiceflow.com/docs/api-reference/sections/build.md) and
[ship it through environments](https://www.voiceflow.com/docs/api-reference/sections/publishing.md).


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