Equipa e funções
O espaço de trabalho pertence à conta que tem o pacote de Monitorização de Prompts. O proprietário convida os colegas na página Equipa do painel: o Starter permite 2 utilizadores e o Pro permite 5, incluindo o proprietário.
Funções
| Função | No painel | Permissões máximas da chave |
|---|---|---|
| Proprietário | Tudo, incluindo equipa, pagamentos e eliminar painéis | Todas |
| Editor | Cria e edita painéis, prompts e concorrentes, inicia medições, gere ligações de partilha | account:read, tools:read, tools:run, tools:orders, pt:read, pt:write |
| Leitor | Vê e exporta dados, não altera nada | account:read, tools:read, tools:orders, pt:read |
No Starter todos os colegas são editores. As funções e o âmbito por cliente estão no Pro.
Chaves dos membros da equipa
A chave pertence a quem a criou e funciona no espaço de trabalho que estava selecionado nesse momento. Usa o pacote, os créditos e os limites desse espaço, e o espaço partilha um só conjunto de chaves (Pro: 3 chaves). As aplicações ligadas por OAuth funcionam da mesma forma: o ecrã de consentimento mostra o espaço de trabalho.
O que uma chave pode fazer é a interseção do que lhe concedeu, do que o pacote permite hoje e do que a sua função permite hoje. Se o proprietário mudar a sua função, a chave acompanha no pedido seguinte. Eliminar painéis, desligar o Google e alterar definições da conta exigem a função de proprietário e devolvem 403 role_forbidden aos colegas.
Se tiver um âmbito por cliente, os painéis fora dele devolvem 404 not_found, tal como os painéis de outra conta.
Quando o acesso termina
Se for removido ou sair, as suas chaves e aplicações ligadas nesse espaço são revogadas de imediato. Se o pacote mudar e o limite de utilizadores for ultrapassado, o acesso fica suspenso e os pedidos devolvem 401 account_inactive até haver um lugar livre. O proprietário vê e pode revogar todas as chaves do espaço.
A gestão da equipa (convites, funções, remover membros) só está disponível no painel, nunca pela API ou pelo MCP.
Clientes da agência (Pro)
No Pro pode agrupar painéis por cliente. GET /v1/clients lista os clientes com os ids dos painéis, POST /v1/clients cria um, PATCH /v1/clients/{client_id} edita ou arquiva e PUT /v1/panels/{panel_id}/client atribui um painel (null remove a atribuição). As escritas aceitam dry_run. GET /v1/workspace/members lista a equipa com e-mails mascarados para proprietários e editores. No MCP as mesmas ações são list_clients, create_client, set_panel_client e list_members.
As ligações de portal do cliente e a marca da agência só se gerem no painel.
GET /v1/me mostra o espaço de trabalho, a sua função e o número de utilizadores.