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

# Workspaces, projects, and tokens

> An organization contains workspaces, a workspace contains projects, and a project owns one agent. A personal access token reaches every workspace you are in.

Workspaces and projects are the containers everything else sits inside. Getting
a `projectID` starts here, and so does understanding how far a single token
reaches.

## 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](/api-reference/authentication) 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](/api-reference/sections/build) and
[ship it through environments](/api-reference/sections/publishing).