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

# Permissões (scopes)

> Scopes das API keys do Flow e rotas correspondentes

# Permissões (scopes)

A chave só consegue o que os scopes permitem. Sem o scope certo a API responde **403**.

| Scope                     | Rota                                                             |
| ------------------------- | ---------------------------------------------------------------- |
| *(qualquer chave válida)* | `GET /external/me`                                               |
| `contacts:write`          | `PUT /external/workspaces/:workspace_id/contacts`                |
| `contacts:read`           | `GET /external/workspaces/:workspace_id/contacts/:contact_id`    |
| `contacts:delete`         | `DELETE /external/workspaces/:workspace_id/contacts/:contact_id` |
| `satisfaction:write`      | `POST /external/workspaces/:workspace_id/satisfaction-surveys`   |
| `mcp:read`                | `ANY /mcp` (servidor MCP somente leitura)                        |

Todas as rotas externas também exigem **billing ativo** no workspace.