Workspaces

Um workspace é um espaço de dados separado dentro da sua organização. Clientes, cobranças, réguas, templates, canais, integrações, webhooks, importações e exportações pertencem a um workspace — e só aparecem para quem tem acesso a ele.

Organização (a sua conta)
└── Workspace          ← espaço de dados (ex.: "Principal", "Varejo")
    └── Empresa        ← pessoa jurídica, com CNPJ (a "matriz")
        └── Filial     ← unidade de negócio dentro da empresa

Toda organização começa com o workspace Principal. Use outros quando precisar de carteiras que não se misturam: operações diferentes, clientes de um parceiro, um ambiente para testes de régua. Para separar unidades de uma mesma carteira, use empresas e filiais.

O que fica no workspace e o que fica na organização

No workspace	Na organização (vale para todos)
Clientes, cobranças, acordos, disputas, tarefas	Membros e papéis (permissões)
Réguas, templates, classificações, canais	Dados cadastrais e marca da conta
Empresas e filiais, layouts de e-mail	Consumo (soma todos os workspaces)
Integrações, webhooks, importações, exportações	Auditoria de membros e de workspaces
Portal do devedor (configuração e subdomínio)

Trocar de workspace

O cabeçalho mostra o workspace ativo ao lado do nome da organização. Clique nele para trocar — as telas passam a mostrar os dados do workspace escolhido. Quem tem acesso a mais de um workspace escolhe em qual entrar logo depois do login.

Criar, renomear e apagar

Na tela Workspaces (menu lateral, grupo Conta):

• Novo workspace cria o espaço já com uma empresa matriz; quem cria vira owner dele. Exige a permissão workspaces.create.
• Renomear e Apagar ficam com os owners do workspace (e com os administradores da organização).
• Apagar esconde todos os dados do workspace e desliga as integrações e webhooks dele. O diálogo mostra quantas pessoas, cobranças, integrações e webhooks serão afetados, e pede o nome do workspace para confirmar. O último workspace da organização não pode ser apagado.

Quem acessa cada workspace

Na tela Membros, o botão de workspaces de cada linha mostra a lista de workspaces da organização. Marque os que o membro pode abrir:

• Desmarcar pausa o acesso (o histórico fica) e encerra a sessão do membro na hora.
• Um workspace nunca fica sem owner: tirar o último é recusado.
• Ao convidar alguém, escolha os workspaces do convite; sem escolha, vale o workspace em que você está.
• Administradores da organização acessam todos os workspaces, inclusive os criados depois.

O que cada um pode fazer dentro do workspace continua definido pelos papéis e permissões.

Na API e no MCP

• API: envie o id do workspace no header X-Workspace-Id. Ele é opcional enquanto a organização tem um só workspace; com dois ou mais, a chamada sem o header responde 400 WORKSPACE_REQUIRED. Liste os workspaces em GET /v1/workspaces. O ID aparece também na tela Workspaces.
• MCP: toda ferramenta que acessa dados aceita o argumento workspace_id; a ferramenta dunning_workspaces_list lista os workspaces da pessoa conectada.
• Webhooks: o corpo de cada entrega traz workspace_id, e um endpoint só recebe os eventos do próprio workspace.