API: membros da equipe, funções e tokens de acesso

Sua equipe é o grupo de pessoas que trabalham no workspace. Cada membro tem uma função (padrão ou personalizada) que define o que ele pode fazer, as criadoras em que trabalha e uma chave de acesso pessoal para entrar. Tokens de acesso são as chaves da API e da conexão MCP. Todos esses endpoints precisam de um token de owner: nos exemplos, $LANACHAT_TOKEN contém um.

Endpoints #

O objeto membro #

{
  "id": "mem_4",
  "name": "Ana",
  "email": "[email protected]",
  "status": "active",
  "role_id": "role_chatter",
  "creator_ids": ["cr_lea", "cr_mia"],
  "overrides": { "billing.read": false, "fans.export": true },
  "access_key": { "active": true, "created_at": "2026-09-20T09:00:00Z" },
  "last_active_at": "2026-10-06T13:40:00Z"
}

Um membro desabilitado não pode entrar e mantém seu histórico, função e criadoras.

O objeto função #

{
  "id": "role_chatter",
  "name": "Chatter",
  "builtin": true,
  "permissions": { "live.read": true, "live.reply": true, "fans.read": true, "fans.export": false, "billing.read": false },
  "members": 6
}

As chaves de permissão seguem as linhas da tabela em Team Management › Roles, agrupadas por área: Dashboard, Creators, AI Brain, Conversations, Vault, Scripts, Playground, Telegram e Employees. Owner sempre tem todas as permissões e não pode ser editado. Manager e Chatter são padrões: você pode alterar suas permissões, mas não renomear ou excluir.

O objeto token de acesso #

{
  "id": "tok_31",
  "name": "Reporting script",
  "permissions": ["can_fan_read", "can_sales_read"],
  "status": "active",
  "created_at": "2026-10-06T15:10:00Z",
  "expires_at": "2027-01-04T15:10:00Z"
}

Membros #

Listar membros #

GET /members · owner

curl "https://api.lanachat.ai/v1/members?status=active&role_id=role_chatter" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

{
  "data": [
    { "id": "mem_4", "name": "Ana", "email": "[email protected]", "status": "active", "role_id": "role_chatter", "creator_ids": ["cr_lea", "cr_mia"], "overrides": {}, "access_key": { "active": true, "created_at": "2026-09-20T09:00:00Z" }, "last_active_at": "2026-10-06T13:40:00Z" }
  ],
  "next_cursor": null
}

Adicionar um membro #

POST /members · owner

curl -X POST https://api.lanachat.ai/v1/members \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ana", "email": "[email protected]", "role_id": "role_chatter", "creator_ids": ["cr_lea"]}'

A resposta é o novo membro (201), ativo, sem chave de acesso ainda.

Obter um membro #

GET /members/{id} · owner

curl https://api.lanachat.ai/v1/members/mem_4 \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

A resposta é o objeto membro. Um id desconhecido responde 404.

Atualizar um membro #

PATCH /members/{id} · owner

curl -X PATCH https://api.lanachat.ai/v1/members/mem_4 \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"creator_ids": ["cr_lea", "cr_mia"], "overrides": {"fans.export": true}}'

A resposta é o membro atualizado. status: "disabled" corta o acesso imediatamente; função e criadoras são mantidas.

Excluir um membro #

DELETE /members/{id} · owner

curl -X DELETE https://api.lanachat.ai/v1/members/mem_4 \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

O membro é removido e suas criadoras são desassociadas. As mensagens antigas mantêm o nome dele. Para manter o membro para depois, desabilite-o em vez de excluir.

Chaves de acesso pessoais #

Membros da equipe não usam senha: entram com uma chave de acesso pessoal. As chaves começam com emp_.

Criar uma chave de acesso #

POST /members/{id}/access-key · owner

curl -X POST https://api.lanachat.ai/v1/members/mem_4/access-key \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

{ "member_id": "mem_4", "sign_in_url": "https://app.lanachat.ai/login/?mode=employee", "access_key": "emp_6Yq2…", "shown_once": true }

Envie o endereço de login e a chave para a pessoa por um canal confiável. Um membro desabilitado responde 409: habilite-o primeiro.

Enviar por e-mail uma chave de acesso #

POST /members/{id}/invitation · owner

curl -X POST https://api.lanachat.ai/v1/members/mem_4/invitation \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

A chave é enviada para o e-mail cadastrado. Um membro sem e-mail ou desabilitado responde 409.

Revogar uma chave de acesso #

DELETE /members/{id}/access-key · owner

curl -X DELETE https://api.lanachat.ai/v1/members/mem_4/access-key \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

A chave para imediatamente e o membro é desconectado. Crie uma nova chave para permitir o acesso novamente.

Funções #

Listar funções #

GET /roles · owner

curl https://api.lanachat.ai/v1/roles \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Uma lista de objetos função: Owner, Manager, Chatter e suas funções personalizadas.

Criar uma função personalizada #

POST /roles · owner

curl -X POST https://api.lanachat.ai/v1/roles \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "Night chatter", "permissions": {"live.read": true, "live.reply": true, "fans.read": true}}'

A resposta é a nova função (201) com builtin: false.

Atualizar uma função #

PATCH /roles/{id} · owner

curl -X PATCH https://api.lanachat.ai/v1/roles/role_chatter \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"permissions": {"fans.export": false}}'

A alteração vale para todos os membros com essa função, exceto suas próprias sobrescritas. Editar Owner, ou renomear Manager ou Chatter, responde 409.

Excluir uma função personalizada #

DELETE /roles/{id} · owner

curl -X DELETE https://api.lanachat.ai/v1/roles/role_night \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Excluir uma função que membros ainda têm responde 409: atribua outra função antes. Funções padrão não podem ser excluídas.

Tokens de acesso #

Listar tokens #

GET /tokens · owner

curl "https://api.lanachat.ai/v1/tokens?include_revoked=true" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Uma lista de objetos token de acesso, sem seus segredos.

Criar um token #

POST /tokens · owner

curl -X POST https://api.lanachat.ai/v1/tokens \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "Reporting script", "permissions": ["can_fan_read", "can_sales_read"], "expires_in_days": 90}'

{ "id": "tok_31", "name": "Reporting script", "token": "lc_live_8f2c1d0e9b7a4c6f", "permissions": ["can_fan_read", "can_sales_read"], "expires_at": "2027-01-04T15:10:00Z" }

token está só nesta resposta. Um token nunca pode ter mais permissões que o token owner que o criou. Nome ausente responde 400.

Atualizar um token #

PATCH /tokens/{id} · owner

curl -X PATCH https://api.lanachat.ai/v1/tokens/tok_31 \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"permissions": ["can_sales_read"]}'

A resposta é o token, sem o segredo. Desligar can_engine também remove permissões de publicação, Advanced AI e relatório de experimentos. Token revogado responde 409.

Rotacionar um token #

POST /tokens/{id}/rotate · owner

curl -X POST https://api.lanachat.ai/v1/tokens/tok_31/rotate \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

A resposta é o token com um novo segredo token, mostrado uma vez. O segredo antigo para imediatamente, atualize seu script logo após. Token revogado responde 409.

Revogar um token #

DELETE /tokens/{id} · owner

curl -X DELETE https://api.lanachat.ai/v1/tokens/tok_31 \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

O token para imediatamente. Token já revogado responde 409.