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
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:| Resource | Description |
|---|---|
| Agents | Voice agents built and deployed within this project |
| Knowledge Base | Documents and content your agents can reference |
| Tools | Custom integrations and functions for your agents |
| Phone Numbers | Telephony numbers assigned to agents in this project |
| Call History | All call recordings, transcripts, and analytics |
| Batch Calls | Outbound call campaigns |
| Secrets | API keys and credentials used by your agents |
| Voices | Custom cloned voices created in this project |
| Members | Your team collaborators and their access levels |
Related Documentation
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