Projects¶

Projects are workspaces that organize your assistants, threads, and resources into logical groups. Each project is isolated — assistants and conversations in one project are separate from another.

The Default "main" Project¶

When you sign up, a project called main is created automatically. You can start using it immediately without any setup. If you only need one workspace, you never have to think about projects at all.

Creating a Project¶

1. Navigate to Projects in the sidebar.
2. Click New Project.
3. Enter a name (up to 100 characters) and a description (up to 500 characters).
4. Click Create.

Your new project appears in the project list and you can switch to it immediately.

Switching Between Projects¶

Click on a project in the project list to switch to it. When you switch projects:

• A new project-scoped JWT token is issued to your browser.
• All subsequent API calls (listing assistants, threads, etc.) are scoped to that project.
• The sidebar and dashboard update to show only that project's resources.

The JWT token contains your user_id and the active project_id. For details on how tokens work and how to use them in integrations, see Authentication.

Deleting a Project¶

Deleting a project permanently removes:

• All assistants in the project
• All threads (conversations) in the project
• All uploaded files and knowledge base data

This action cannot be undone. You cannot delete your last remaining project.

API Reference¶

See the full API documentation at /docs#Projects.

Related Pages¶

• Overview
• Assistants
• Authentication (Integration)