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

# Projects Overview

> Organize your work and collaborate with your team using projects

## 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.

<Info>
  **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
</Info>

## 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:

| 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

<CardGroup cols={2}>
  <Card title="Managing Projects" href="./managing-projects">
    Create, rename, and deactivate projects
  </Card>

  <Card title="Team Collaboration" href="./team-collaboration">
    Invite teammates and manage your project members
  </Card>

  <Card title="Roles & Permissions" href="./roles-and-permissions">
    Understand what each role can do and how to customize access
  </Card>

  <Card title="API Keys" href="../create-api-keys">
    Generate API keys for your project
  </Card>
</CardGroup>