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

# Workspaces

> Understand what a workspace is and how to organize instances, keys, plan, and team on Notifique.

<Tip>
  A workspace is the **customer folder** on Notifique: instances, API keys, plan, balance, webhooks, and team all live inside it. Each key opens one folder only.
</Tip>

## In short

* Every `/v1/...` call runs in the workspace tied to your **API Key**.
* One workspace **cannot see** another's data.
* In the dashboard you manage channels, team, billing, and [Trust Factor](/guides/workspaces/trust-factor).
* In most cases **do not send** `X-Workspace-Id`, the key already defines the workspace.

## When to use one or many

| Situation                          | Recommendation               |
| ---------------------------------- | ---------------------------- |
| One brand, one team                | **1 workspace**              |
| Separate production and staging    | **2 workspaces**             |
| SaaS with one customer per account | **1 workspace per customer** |

## What's inside?

| Area            | Examples                                              |
| --------------- | ----------------------------------------------------- |
| **Channels**    | WhatsApp/Telegram instances, email domains, push apps |
| **Integration** | API keys, webhooks, templates                         |
| **Billing**     | Plan, credits, BRL balance                            |
| **Team**        | Members and dashboard permissions                     |
| **Reputation**  | [Trust Factor](/guides/workspaces/trust-factor)       |

## In the dashboard

Open **Workspace → Settings**:

1. View **plan, credits, and balance**
2. Manage **team** and permissions
3. Connect **instances**, domains, and push apps
4. Adjust **inbound messages** under Settings → Received messages
5. Track **Trust Factor**

## Via API

Scopes: `workspace:read`, `workspace:create`, `workspace:update`, `workspace:delete`.

| Action | Method                      | Note                                                   |
| ------ | --------------------------- | ------------------------------------------------------ |
| Create | `POST /v1/workspaces`       | Account limit? **403** `WORKSPACE_SLOTS_LIMIT_REACHED` |
| Get    | `GET /v1/workspaces/:id`    | `:id` must match the key's workspace                   |
| Update | `PUT /v1/workspaces/:id`    | Name, color, defaults, partial inbound                 |
| Delete | `DELETE /v1/workspaces/:id` | Requires **≥2** workspaces on the account              |

### Create workspace

```http theme={null}
POST https://api.notifique.dev/v1/workspaces
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "name": "My New Workspace",
  "color": "#3B82F6"
}
```

***

## Next steps

* [Trust Factor](/guides/workspaces/trust-factor): reputation and send limits
* [API Keys](/guides/api-key/index): scopes and best practices
* [Billing](/guides/introducao/cobranca-e-pague-pelo-uso): plan and credits
* [Webhooks](/guides/webhooks/index): real-time notifications