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

# Projects

> Organize your agents into projects

# Projects

Projects let you group related agents together. Every agent belongs to exactly one project.

## Default Project

When your partner account is approved, a **Default** project is automatically created. All agents created via the API are assigned to this default project unless you specify a `project_id`.

The default project cannot be deleted.

## API Endpoints

Full CRUD is available via the Partner API:

| Method   | Endpoint        | Description                            |
| -------- | --------------- | -------------------------------------- |
| `GET`    | `/projects`     | List all projects                      |
| `POST`   | `/projects`     | Create a new project                   |
| `GET`    | `/projects/:id` | Get a single project                   |
| `PUT`    | `/projects/:id` | Update project name/description        |
| `DELETE` | `/projects/:id` | Delete a project (must have no agents) |

### Create a project

```bash theme={null}
curl -X POST https://api.vocobase.com/api/v2/projects \
  -H "Authorization: Bearer rg_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Client A", "description": "Agents for Client A"}'
```

```json theme={null}
{
  "success": true,
  "data": {
    "id": "proj_abc123",
    "name": "Client A",
    "description": "Agents for Client A",
    "is_default": false,
    "agent_count": 0,
    "created_at": "2026-03-26T10:00:00.000Z",
    "updated_at": "2026-03-26T10:00:00.000Z"
  }
}
```

### Delete constraints

* Cannot delete the **default** project
* Cannot delete a project that **still has agents** — move or delete them first

## Dashboard

Projects can also be managed from the [Vocobase Dashboard](https://app.vocobase.com/dashboard/projects):

* Create, edit, and delete projects
* Filter agents by project on the Agents page
* Assign agents to projects when creating or editing them

## How Agents Relate to Projects

```
Partner Account
├── Default Project
│   ├── Agent: Sales Bot
│   ├── Agent: Support Bot
│   └── Agent: Onboarding Bot
├── Client A Project
│   ├── Agent: Client A Inbound
│   └── Agent: Client A Outbound
└── Client B Project
    └── Agent: Client B Support
```