Minha conta
Perfil, sessões, chaves pessoais e preferências de quem está autenticado.
Consultar minha conta
Devolve o perfil de quem chama: e-mail, nome, foto, vínculos com organizações, permissões efetivas, situação do segundo fator, e-mail de recuperação, preferência de MCP e escopo de empresas. Para uma chave de API, devolve o nome da chave e suas permissões. Qualquer ator autenticado.
Atualizar meu perfil
Atualiza `display_name` (até 120 caracteres) e/ou `avatar_file_id`, que deve ser uma foto enviada pela própria pessoa. Devolve a conta atualizada. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Iniciar envio de foto de perfil
Registra o arquivo da foto e devolve uma URL pré-assinada para enviar o conteúdo com `PUT`, com os cabeçalhos exigidos e o prazo de validade. Aceita `image/png`, `image/jpeg` ou `image/webp` dentro do tamanho máximo (`400` caso contrário). Responde `201`. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Concluir envio de foto de perfil
Confirma que o arquivo `file_id` (UUID) foi enviado ao armazenamento com o tipo e o tamanho declarados. Arquivo de outra pessoa ou inexistente retorna `404`; envio incompleto retorna `409`. Depois, associe a foto com a atualização do perfil. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Definir e-mail de recuperação
Inicia a troca do e-mail de recuperação enviando um código de 6 dígitos ao novo endereço, válido por 10 minutos. O endereço não pode ser o e-mail de login (`400`) nem estar em uso por outra conta (`409` `recovery_email_in_use`). Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Confirmar e-mail de recuperação
Confirma o e-mail de recuperação com o código recebido. Código errado ou expirado retorna `401` `mfa_invalid`. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Trocar organização atual
Muda a organização atual da sessão para `organization_id`, onde a pessoa precisa ter vínculo ativo (`404` caso contrário). Organização suspensa ou inativa retorna erro; se a organização exige segundo fator ainda não satisfeito, retorna `403` `mfa_challenge_required` ou `mfa_enrollment_required`. Em organizações com sessão única, as demais sessões da pessoa nela são encerradas. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Listar minhas sessões
Lista as sessões da pessoa autenticada, marcando a atual com `is_current` e indicando a organização de cada uma. Listagem paginada no envelope `{items, page}`, com `limit`, `cursor`, `sort`, `q` e `filter`. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Encerrar uma das minhas sessões
Revoga a sessão `sid` da própria pessoa. Sessão inexistente, de outra pessoa ou já encerrada retorna `404`. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Encerrar minhas outras sessões
Revoga todas as sessões da pessoa, exceto a atual, e esquece todos os dispositivos confiáveis. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Sair da organização
Remove o vínculo de quem chama com a organização atual. O último proprietário ativo não pode sair (`409` `last_owner`). Exige uma pessoa autenticada (não uma chave de API), com vínculo ativo na organização atual e segundo fator satisfeito.
Alterar minha senha
Troca a senha após conferir `current_password` (`400` `invalid_credentials` se errada). A nova senha precisa ter ao menos 12 caracteres e não constar em vazamentos conhecidos. A sessão atual continua ativa e todos os dispositivos confiáveis são esquecidos. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Ativar ou desativar meu acesso MCP
Liga ou desliga, com `enabled`, o uso do MCP por clientes de IA em nome da pessoa. Devolve o valor resultante. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Criar minha chave de API
Cria uma chave de API pessoal e devolve o segredo uma única vez, aceitando `expires_at` e `allowed_cidrs`. As permissões devem estar entre as permissões efetivas de quem cria (ou ser copiadas de `from_role_id`); permissões não permitidas retornam `400` `api_key_forbidden_permission`. Responde `201`. Exige uma pessoa autenticada (não uma chave de API), com vínculo ativo na organização atual e segundo fator satisfeito.
Listar minhas chaves de API
Lista as chaves de API pessoais criadas por quem chama na organização atual. Listagem paginada no envelope `{items, page}`, com `limit`, `cursor`, `sort`, `q` e `filter`. Exige uma pessoa autenticada (não uma chave de API), com vínculo ativo na organização atual e segundo fator satisfeito.
Consultar minha chave de API
Devolve os dados de uma chave pessoal (sem o segredo): prefixo, permissões, validade, CIDRs, último uso e revogação. `key_id` é o UUID da chave; chave de outra pessoa ou de outra organização retorna `404`. Exige uma pessoa autenticada (não uma chave de API), com vínculo ativo na organização atual e segundo fator satisfeito.
Atualizar minha chave de API
Altera nome, permissões, `expires_at` ou `allowed_cidrs` de uma chave pessoal (`key_id` é o UUID). As permissões devem estar entre as permissões efetivas de quem chama (`400` `api_key_forbidden_permission`). Chave de outra pessoa retorna `404`. Exige uma pessoa autenticada (não uma chave de API), com vínculo ativo na organização atual e segundo fator satisfeito.
Revogar minha chave de API
Revoga imediatamente uma chave pessoal (`key_id` é o UUID). Chave de outra pessoa ou já revogada retorna `404`. Exige uma pessoa autenticada (não uma chave de API), com vínculo ativo na organização atual e segundo fator satisfeito.