# Teamspaces

{% hint style="warning" %}
Requires various [permissions](/docs/settings/workspace/roles-and-permissions.md) to view and edit the respective teamspace settings.
{% endhint %}

***

## Definition

Every workspace can have one or more teamspaces. These are collections of preferences that affect its associated AI agents, live agent teams, and the corresponding users and people they affect. For specifics on these preferences, jump to:

* [Banning](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/banning?tab=ban_rules)
* [Tags](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/tags?tab=tags)
* [Assignment](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/assignment)
* [Email Domains](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/email-domains)
* [Email Templates](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/email-templates)
* [Exports](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/exports)
* Livechat
  * [Canned Replies](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/livechat/canned-replies)
  * [Custom Fields](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/livechat/custom-fields)
* Tickets
  * [Custom Fields](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/tickets/custom-fields)
* Customers
  * [Profile iframe](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/customers/profile-iframe)
  * [Custom Fields](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/customers/custom-fields)
* Analytics

***

## Configuration

To manage teamspaces, go to the [settings panel](/docs/settings/settings.md). Under the "Workspace" category select **Teamspaces**.

### Create a Teamspace

1. In Teampace settings select **Create Teamspace.**
2. Edit the new teampace's settings as described below.
3. Select **Create**.

***

### Teamspace Settings

Select the **teampace** in the Teamspace table for its panel options:

* **Avatar** (optional) — an image to visually identify the teampace in Proto AICX.
* **Teamspace name** — the title of the eampace.
* **Description** (optional) — a short description to help orient users when viewing the Teampace table.

Press **Save** to commit any edits.

Existing teampaces have static fields with values that can be copied and utilized with the [Developer API](/docs/developer-documentation/developer-api.md):

* **Teasmapce ID**
* **Takeover Secret**

***

### Delete a Teamspace

* In the Teampace table, select one or more teampace **checkboxes**.
* Select **Delete Teamspace** and confirm.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.proto.cx/docs/settings/teamspaces.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.