Skip to main content

​
What is a Project?

A project is your workspace on the Hamsa platform. Everything you build — agents, knowledge bases, phone numbers, tools, call history, and more — lives inside a project. When you first sign up, a Default project is automatically created for you. You can start building right away, or create additional projects to organize different workstreams, clients, or environments.
Projects allow you to:
  • Separate resources by team, client, or use case
  • Invite teammates and assign them roles
  • Control what each team member can see and do
  • Manage your workspace independently from your personal account settings

​
The Default Project

Every account comes with a Default project. This project:
  • Is created automatically when your account is set up
  • Cannot be renamed, deleted, or deactivated
  • Works exactly like any other project for building and running agents
You can create as many additional projects as you need alongside it.

​
Switching Between Projects

You can switch between projects at any time using the project switcher in the top navigation bar. Selecting a different project changes the context for everything in the platform — agents, call history, phone numbers, and all other resources are scoped to the currently selected project.

​
Finding Your Project ID

Some API endpoints require a Project ID to identify which project the request applies to. You can copy your Project ID directly from the project switcher in the top navigation bar — click the switcher and use the copy icon next to the project name.

​
What’s in a Project?

Each project has its own isolated set of resources:

Managing Projects

Create, rename, and deactivate projects

Team Collaboration

Invite teammates and manage your project members

Roles & Permissions

Understand what each role can do and how to customize access

API Keys

Generate API keys for your project