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

> Entenda o que é um workspace e como organizar instâncias, chaves, plano e equipe na Notifique.

<Tip>
  Workspace é a **pasta do cliente** na Notifique: instâncias, chaves de API, plano, saldo, webhooks e equipe ficam todos dentro dela. Cada chave abre uma pasta só.
</Tip>

## Em poucas palavras

* Toda chamada `/v1/...` roda no workspace da sua **API Key**.
* Um workspace **não enxerga** dados de outro.
* No painel você gerencia canais, equipe, cobrança e [Trust Factor](/guides/workspaces/trust-factor).
* Na maioria dos casos **não envie** `X-Workspace-Id`, a chave já define o workspace.

## Quando usar um ou vários?

| Situação                         | Recomendação                |
| -------------------------------- | --------------------------- |
| Uma marca, um time               | **1 workspace**             |
| Produção e homologação separados | **2 workspaces**            |
| SaaS com um cliente por conta    | **1 workspace por cliente** |

## O que fica dentro?

| Área           | Exemplos                                                    |
| -------------- | ----------------------------------------------------------- |
| **Canais**     | Instâncias WhatsApp/Telegram, domínios de e-mail, apps push |
| **Integração** | Chaves de API, webhooks, templates                          |
| **Cobrança**   | Plano, créditos, saldo em reais                             |
| **Equipe**     | Membros e permissões no painel                              |
| **Reputação**  | [Trust Factor](/guides/workspaces/trust-factor)             |

## No painel

Abra **Workspace → Settings**:

1. Veja **plano, créditos e saldo**
2. Gerencie **equipe** e permissões
3. Conecte **instâncias**, domínios e apps push
4. Ajuste **mensagens recebidas** em Settings → Received messages
5. Acompanhe o **Trust Factor**

## Via API

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

| Ação      | Método                      | Observação                                               |
| --------- | --------------------------- | -------------------------------------------------------- |
| Criar     | `POST /v1/workspaces`       | Limite da conta? **403** `WORKSPACE_SLOTS_LIMIT_REACHED` |
| Consultar | `GET /v1/workspaces/:id`    | `:id` deve ser o workspace da chave                      |
| Editar    | `PUT /v1/workspaces/:id`    | Nome, cor, defaults, inbound parcial                     |
| Excluir   | `DELETE /v1/workspaces/:id` | Precisa de **≥2** workspaces na conta                    |

### Criar workspace

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

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

***

## Próximos passos

* [Trust Factor](/guides/workspaces/trust-factor): reputação e limites de envio
* [Chaves de API](/guides/api-key/index): escopos e boas práticas
* [Cobrança](/guides/introducao/cobranca-e-pague-pelo-uso): plano e créditos
* [Webhooks](/guides/webhooks/index): avisos em tempo real