Em poucas palavras
- Toda chamada
/v1/...roda no workspace da sua API Key - Um workspace não enxerga dados de outro
- O primeiro workspace nasce no
POST /v1/platform/verify(registro) — não noregister - Workspaces adicionais:
POST /v1/workspacescom escopoworkspace:create - Na API v1 não envie o cabeçalho
x-workspace-id— o workspace vem só da API Key. Se enviado, a API responde 400 (WORKSPACE_HEADER_NOT_ALLOWED).
Primeiro vs segundo workspace
Fluxo completo para agentes: Registro e verificação.
Quando usar um ou vários?
API (/v1/workspaces)
Escopos: workspace:read, workspace:create, workspace:update, workspace:delete.
Listar com sessão (todos os workspaces)
ComsessionToken de login (não API key de mensageria):
GET /v1/platform/workspaces — lista todos os workspaces da conta com role (OWNER, ADMIN, MEMBER). ?include=billing exige billing:read.
Billing do workspace
Plano, saldo e cartões usam rotas Platform com o mesmoworkspaceId:
GET /v1/platform/workspaces/:id/subscriptionGET /v1/platform/workspaces/:id/balanceGET /v1/platform/workspaces/:id/payment-methodsGET /v1/platform/workspaces/:id/credits/usage— ledger de créditos comcorrelationId, canal e chave usada (billing:read)
Equipe (membros e convites)
Gerencie quem acessa o workspace via Platform API — escoposworkspace:members:read / workspace:members:manage:
/v1/workspaces/:id/* com API key de mensageria (escopos de workspace).

