Endpoint REST

Todos os endpoints usam a URL base https://api.hashee.ai. Autenticacao via Authorization: Bearer {token} exceto quando marcado como publico.

Auth

Metodo	Caminho	Auth	Descricao
POST	/auth/register	Publico	Registrar nova conta
POST	/auth/login	Publico	Login com senha
POST	/auth/login-code	Publico	Login com codigo de verificacao
POST	/auth/send-code	Publico	Enviar codigo de verificacao
POST	/auth/refresh	Cookie	Renovar access token
POST	/auth/logout	JWT	Logout da sessao atual
POST	/auth/reset-password	Publico	Redefinir senha da conta
POST	/auth/change-password	JWT	Alterar senha da conta
POST	/auth/change-protection-password	JWT	Alterar senha de protecao
GET	/auth/me	JWT	Obter perfil do usuario atual
POST	/auth/passkey/begin	Publico	Iniciar login com Passkey
POST	/auth/passkey/complete	Publico	Completar login com Passkey
POST	/auth/passkey/register/begin	JWT	Iniciar registro de Passkey
POST	/auth/passkey/register/complete	JWT	Completar registro de Passkey
GET	/auth/passkey/credentials	JWT	Listar credenciais Passkey
PATCH	/auth/passkey/credentials/:id	JWT	Renomear uma Passkey
DELETE	/auth/passkey/credentials/:id	JWT	Excluir uma Passkey

Usuarios

Metodo	Caminho	Auth	Descricao
GET	/users/me	JWT	Obter perfil proprio
PATCH	/users/me	JWT	Atualizar perfil proprio
GET	/users/:id	JWT	Obter usuario por ID
GET	/users/search	JWT	Pesquisar usuarios
DELETE	/users/me	JWT	Desativar e excluir conta
PATCH	/users/contacts/:id	JWT	Definir apelido de contato

Chaves E2EE

Metodo	Caminho	Auth	Descricao
POST	/keys/backup	JWT	Upload de backup de chave criptografada
GET	/keys/backup	JWT	Download de backup de chave
PUT	/keys/backup	JWT	Atualizar backup de chave
GET	/keys/users/:id/devices	JWT	Obter chaves publicas dos dispositivos do usuario
GET	/keys/agents/:id	JWT	Obter chave publica do agente
GET	/keys/groups/:id	JWT	Obter chave de criptografia do grupo
POST	/keys/groups/:id/rotate	JWT	Rotacionar chave do grupo
POST	/keys/rotation/request	JWT	Solicitar rotacao de chave H2H
POST	/keys/rotation/confirm	JWT	Confirmar rotacao de chave H2H
POST	/agents/:id/keys/register	Agent	Registrar chave publica do agente

Conversas

Metodo	Caminho	Auth	Descricao
GET	/conversations	JWT	Listar conversas
PATCH	/conversations/:id	JWT	Atualizar configuracoes da conversa
DELETE	/conversations/:id	JWT	Ocultar conversa
POST	/conversations/:id/read	JWT	Marcar como lida
GET	/conversations/:id/messages	JWT	Obter historico de mensagens
GET	/conversations/:id/media	JWT	Obter midia na conversa
PUT	/conversations/:id/draft	JWT	Salvar rascunho
GET	/conversations/:id/draft	JWT	Obter rascunho
DELETE	/conversations/:id/draft	JWT	Excluir rascunho

Mensagens

Metodo	Caminho	Auth	Descricao
POST	/conversations/:id/messages	JWT	Enviar uma mensagem
POST	/messages/:id/recall	JWT	Revogar uma mensagem
POST	/messages/:id/reactions	JWT	Adicionar/remover reacao
GET	/messages/:id/reactions	JWT	Obter lista de reacoes
POST	/messages/forward	JWT	Encaminhar mensagens (max 10 destinos)
PATCH	/messages/:id/artifact	Agent	Atualizar um artifact

Grupos

Metodo	Caminho	Auth	Descricao
POST	/groups	JWT	Criar grupo
GET	/groups/:id	JWT	Obter detalhes do grupo
PATCH	/groups/:id	JWT	Atualizar configuracoes do grupo
DELETE	/groups/:id	JWT	Excluir grupo
GET	/groups/:id/members	JWT	Listar membros
POST	/groups/:id/members	JWT	Adicionar membros
DELETE	/groups/:gid/members/:mid	JWT	Remover membro
PATCH	/groups/:gid/members/:mid	JWT	Atualizar papel do membro
PATCH	/groups/:gid/members/me	JWT	Atualizar perfil proprio no grupo
POST	/groups/:gid/leave	JWT	Sair do grupo
POST	/groups/:id/transfer	JWT	Transferir propriedade
POST	/groups/:gid/join	JWT	Entrar no grupo via codigo de compartilhamento
GET	/groups/:gid/join-requests	JWT	Listar solicitacoes de entrada pendentes
POST	/groups/:gid/join-requests/:uid/approve	JWT	Aprovar solicitacao de entrada
POST	/groups/:gid/join-requests/:uid/reject	JWT	Rejeitar solicitacao de entrada
POST	/groups/:id/pinned-messages	JWT	Fixar uma mensagem
GET	/groups/:id/pinned-messages	JWT	Listar mensagens fixadas
DELETE	/groups/:gid/pinned-messages/:mid	JWT	Desafixar uma mensagem
POST	/groups/:gid/members/:mid/mute	JWT	Silenciar um membro
POST	/groups/:id/agent-instances	JWT	Adicionar agente ao grupo
DELETE	/groups/:gid/agent-instances/:iid	JWT	Remover agente do grupo

Gerenciamento de Agentes (Criador)

Metodo	Caminho	Auth	Descricao
POST	/agents	JWT	Criar agente
GET	/agents	JWT	Listar agentes proprios
GET	/agents/:id	JWT	Obter detalhes do agente
PATCH	/agents/:id	JWT	Atualizar perfil do agente
DELETE	/agents/:id	JWT	Excluir agente
GET	/agents/check-id	JWT	Verificar disponibilidade de ID personalizado
GET	/agents/:id/token	JWT	Obter agent token
POST	/agents/:id/token/regenerate	JWT	Regenerar token
GET	/agents/:id/commands	JWT	Obter comandos slash
POST	/agents/:id/commands	JWT	Atualizar comandos slash
GET	/agents/:id/invite-codes	JWT	Listar codigos de convite
POST	/agents/:id/invite-codes	JWT	Criar codigo de convite
PATCH	/invite-codes/:id	JWT	Atualizar codigo de convite
GET	/agents/:id/requests	JWT	Listar solicitacoes de usuarios
POST	/agents/:id/requests/:rid/approve	JWT	Aprovar solicitacao de usuario
POST	/agents/:id/users/:uid/suspend	JWT	Suspender usuario
POST	/agents/:id/users/:uid/restore	JWT	Restaurar usuario
GET	/agents/:id/governance	JWT	Obter status de governanca

Endpoints de Agente (Auth com Agent Token)

Metodo	Caminho	Auth	Descricao
POST	/agents/:id/conversations/:cid/messages	Agent	Enviar mensagem
POST	/agents/:id/typing	Agent	Enviar indicador de digitacao
GET	/agents/:id/messages/poll	Agent	Buscar mensagens (poll)
GET	/agents/:id/conversations	Agent	Listar conversas
GET	/agents/:id/conversations/:cid/messages	Agent	Obter mensagens da conversa
POST	/agents/:id/files	Agent	Solicitar URL de upload de arquivo
PUT	/agents/:id/files/:uploadId/upload	Agent	Upload de binario do arquivo

Arquivos

Metodo	Caminho	Auth	Descricao
POST	/files/presign	JWT	Solicitar URL de upload pre-assinada
PUT	/files/:upload_id/upload	JWT	Upload de binario do arquivo
POST	/files/confirm	JWT	Confirmar upload com SHA-256

Outros

Metodo	Caminho	Auth	Descricao
GET	/health	Publico	Verificacao de saude
GET	/search	JWT	Pesquisar atores e artifacts
POST	/reports	JWT	Reportar um agente
POST	/share/friend	JWT	Criar link de compartilhamento de amigo
POST	/share/agent	JWT	Criar link de compartilhamento de agente
POST	/share/group	JWT	Criar link de compartilhamento de grupo
GET	/share/*	Publico	Resolver link de compartilhamento

Proximos Passos

• Eventos WebSocket — Referencia de eventos em tempo real
• Autenticacao — Detalhes do fluxo de auth
• Codigos de Erro — Tabela de codigos de erro