> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/realtime-agent/projects.md).

# Projects

Create, import, export and delete realtime agent projects, and see which phone numbers are live.

Choose **Realtime** on the product screen. **All projects** lists the realtime agents of your organization. **LIVE** marks an agent that is deployed to at least one phone number; filter the list with **All** or **Live**. Find an agent with **Search**, and sort the list **Alphabetical**, by **Created** or by **Updated** date. The clock icon in a row shows the agent's current version.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-9d7c17b96dfe9b2efbe1ea5a214e38cd0dd8ffb8%2Frealtime-projects-list.png?alt=media" alt="The Realtime project list with Search set to Docs, the All and Live filters, the sort button, Select and Create, and one project row with its clock icon"><figcaption><p>The project list, filtered with Search</p></figcaption></figure>

## Create a project

1. Click **Create**.
2. Enter a **Name** and, if you like, a **Description**.
3. Click **Create**. The editor opens.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-70b9a98a170dd016af58876fd9caeb5bb5b3ac60%2Frealtime-projects-create.png?alt=media" alt="The Create project dialog with Name, Description (Optional), and the Import and Create buttons"><figcaption><p>Creating a realtime project</p></figcaption></figure>

Users with the **EndUser** role cannot create projects.

### Import a project

In the same dialog, click **Import** and choose a `.json` file exported from another realtime project. The new project gets the prompt, voice settings, skills and MCP servers of the exported one.

## Project details

Click a project in the list, or **Settings** in the editor, to open its details:

* **Details** – the project description (edit it with the pencil icon), **Organization ID**, **Project ID**, and who created and last updated the project and when. **Export** and **Open** are at the bottom, the trash icon deletes the project.
* **What's live** – the phone numbers the agent is deployed to. **Disconnect** a number, or **Disconnect all**. With nothing deployed, you see **No live versions yet.**

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-64edb89d8beea5d87fbacc78833df21206ee1359%2Frealtime-project-details.png?alt=media" alt="The project details panel on the Details tab with the description, the blurred Organization ID and Project ID, Updated and Created, the trash icon, and the Export and Open buttons"><figcaption><p>Project details</p></figcaption></figure>

### Export a project

**Export** downloads the agent as a `.json` file – prompt, skills, voice settings and MCP servers. Use it to copy an agent to another project or environment.

{% hint style="warning" %}
The exported file contains the settings of your MCP servers, **including their tokens**. Store it securely and do not share it.
{% endhint %}

## Delete a project

In the project list, click **Select**, tick the project and click **Delete** – or use the trash icon in the project details.

{% hint style="warning" %}
**Disconnect all phone numbers first** in **What's live**. Deleting a project does not take its numbers offline.
{% endhint %}

## Users

The **Users** tab in the project details lists who works on the agent: the **Project members** with their role, and the **Organisation admins**, who have access to every project without being on the list. **Search users on this project or find people to add** finds both members and people of your organization who are **Not on this project yet**.

The project's **Owners** add people, change their role and remove them (with **Confirm removal**). Only members of the agent's organization can be added, and **EndUser** members only as Viewers. An agent always keeps at least one Owner.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FMLqqPZSUHeaCmXbkdyrZ%2Frealtime-projects-users-tab.png?alt=media" alt="The Users tab of the realtime project Docs – Opening hours with the Project members and Organisation admins buttons, the search field Search users on this project or find people to add, and one member Docu generator with the role Owner"><figcaption><p>The Users tab of a realtime project</p></figcaption></figure>

## Who can do what

| Role                   | What they can do                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| **Organisation admin** | Full access to every project – edit, deploy, delete – without being on the list.           |
| **Owner**              | Everything, plus deleting the project and managing people.                                 |
| **Editor**             | Edit, restore versions, deploy and go live – including test calls and connecting Insights. |
| **Viewer**             | Read-only – sees the editor and history, changes nothing.                                  |

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FCwH4W1sgjb52JIGKsWPZ%2Frealtime-projects-roles-info.png?alt=media" alt="The Roles and access panel opened from the info icon on the Users tab, describing Organisation admin, Owner, Editor and Viewer"><figcaption><p>Roles and access, from the info icon on the Users tab</p></figcaption></figure>

* **EndUsers** are always read-only and cannot create projects.
* A project you have no access to is not shown at all.
* When your role changes, your open editor session is disconnected, so the new rights apply at once.

See [Users and roles](https://docs.borndigital.ai/getting-started/users-and-roles.md).
