Skip to main content

​
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:
MethodEndpointDescription
GET/projectsList all projects
POST/projectsCreate a new project
GET/projects/:idGet a single project
PUT/projects/:idUpdate project name/description
DELETE/projects/:idDelete a project (must have no agents)

​
Create a project

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"}'

{
  "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:
  • 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