← Início
Desenvolvedores
Referência da API
Construa em cima da Anna. Cada endpoint abaixo é servido pelo host da imanna — autentique, chame, integre.
publicbearersessioninstallingest-keyadmin
público — sem autenticação · bearer — token da conta imanna (Authorization: Bearer) · sessão — cookie da conta ou bearer · install — id/HMAC de instalação de módulo · ingest-key — chave de ingestão por projeto · admin — sessão de operador.
Chat e construção
POST/v1/completeCompletação do cérebro medida por créditos — o servidor injeta as skills hospedadas e retorna apenas a saída.bearer
POST/v1/interactO pipeline de interação (chat → esclarecer → planejar → rascunho → build → concluído).bearer
POST/v1/askPergunta única respondida com o contexto da conta/projeto.bearer
POST/v1/buildConstrói um projeto em arquivos reais (passagem única, ou o job orquestrado quando acima da linha de ativação).bearer
POST/v1/build/planPlaneja um build e retorna a decisão de ativação e uma faixa de créditos estimada (o cartão de confirmação).bearer
GET/v1/build/jobConsulta o status de um job de build assíncrono orquestrado (por id, ou buscando pelo projeto).bearer
POST/v1/review/planPlaneja uma revisão de código sobre um projeto existente (unidades de revisão em blocos).bearer
Projetos
GET·POST·DELETE/v1/projectsLista (próprios + compartilhados, cada um com papel + hasBuild) / cria / atualiza / exclui um projeto.bearer
GET/v1/projects/interactionO plano, a lista de tarefas e o rastreio sem conteúdo sensível de um projeto.bearer
GET/v1/projects/filesA lista de arquivos construídos (sem o conteúdo) + flags draft/hasBuild. Colaboradores passam ?owner=<id>.bearer
GET·PUT/v1/projects/fileLê um arquivo construído / salva uma edição (dono ou colaborador com permissão de edição).bearer
GET/v1/projects/buildO manifesto construído COM o conteúdo dos arquivos — o que o desktop grava em disco (…/files não traz conteúdo).bearer
POST/v1/projects/local-writtenConfirma que um build de projeto local chegou à sua pasta; libera a cópia de trabalho na nuvem. Somente o dono.bearer
POST/v1/projects/uploadAdiciona um recurso inerte a um projeto (armazenado como não executável).bearer
GET/v1/projects/downloadBaixa o build do projeto como um .zip.bearer
GET·POST·DELETE/v1/projects/collaboratorsLista / convida (view|edit) / remove um colaborador do projeto.bearer
POST/v1/projects/leaveRecusa ou sai de um projeto compartilhado com você (remove seu compartilhamento + o registro do dono para você).bearer
GET·POST/v1/projects/inboxA caixa de entrada de ingestão de um projeto (registros enviados por uma integração criada pela Anna via chave de ingestão).bearer
POST/v1/projects/proxyRequisição protegida no servidor para um painel de projeto (com proteção contra SSRF e CORS habilitado).chave de ingestão
GET/v1/projects/widgetO snippet do widget de chat do merchant para um projeto.público
Base de conhecimento do projeto
GET·POST·DELETE/v1/projects/kbLista / cria / exclui as entradas da KB de um projeto (ajuda ou docs de API).bearer
POST/v1/projects/kb/publishPublica a KB de um projeto como central de ajuda pública (quatro layouts).bearer
POST/v1/projects/kb/generateGera rascunhos de docs de ajuda / API a partir dos arquivos construídos do projeto.bearer
GET/v1/projects/kb/searchBusca na KB de um projeto (também usada para responder o chat com escopo no projeto).bearer
GET/v1/kbA KB de produto da conta (o que o negócio vende) — listar/gravar/excluir.bearer
GET/v1/kb/publicUma KB de projeto publicada, servida somente leitura como central de ajuda.público
Skills, memória e aprendizado
POST·GET/v1/skills/putSalva uma skill aprendida no repositório de skills da conta.bearer
GET/v1/skills/listLista as skills aprendidas da conta.bearer
GET/v1/skills/groupsOs grupos de capacidades que a conta pode ativar.bearer
POST·GET/v1/memory/putGrava um fato de memória do projeto (o cache do cérebro do ingestor).bearer
GET/v1/memory/listLista os fatos de memória de um projeto.bearer
POST/v1/traces/outcomeRegistra o resultado de uma execução (mantida/revertida) para o ciclo de aprendizado.bearer
GET/v1/traces/scoresPontuações das skills calculadas a partir do log de rastreios.bearer
POST/v1/learn/scanEscaneia os arquivos de um projeto → achados de drift/cobertura.bearer
POST/v1/learn/coverageAuditoria de cobertura de um projeto (código não coberto que o cérebro não documenta).bearer
Imagens e 3D
POST/v1/image/generateGera uma imagem inline — raster (foto/arte) ou vetor exato (gráfico/logo/sobreposição).bearer
GET·POST/v1/3d/keyArmazena/limpa a chave de API Tripo da própria conta (BYO) + status da conexão.bearer
POST/v1/3d/generateEnvia uma geração Tripo de texto/imagem → GLB (acesso total, chave BYO; sem trava de entitlement).bearer
GET/v1/3d/statusConsulta uma tarefa Tripo → status/progresso/url do GLB.bearer
POST/v1/3d/uploadAnexa um arquivo de modelo 3D do usuário a uma conversa (acesso total; armazenado inerte).bearer
GET/v1/3d/modelsA biblioteca da trilha 3D — modelos salvos, tarefas em andamento e o espaço próprio da trilha.bearer
GET/v1/3d/modelUm modelo salvo: manifesto (peças nomeadas, triângulos, dimensões), linhagem e quais edições são locais vs regeneração.bearer
GET/v1/3d/model/downloadBaixa um modelo salvo — link permanente, ao contrário da url de ~24h da Tripo.bearer
POST/v1/3d/model/patchEdições locais só no JSON (escala/mover/girar/renomear/remover/material/apoiar/unidades). Cria um novo modelo, nunca sobrescreve, sem créditos, sem reescrever geometria.bearer
POST/v1/3d/model/renameRenomeia um modelo salvo (o arquivo não é alterado).bearer
POST/v1/3d/model/deleteExclui um modelo salvo — libera só a cota da trilha 3D; o armazenamento de projetos não é afetado.bearer
Módulos
GET/v1/modulesO catálogo de módulos + o estado de ativação da conta.bearer
POST/v1/modules/activateAutoativa um módulo em um projeto (grátis, acesso total).bearer
POST/v1/autodocs/generateGera documentação em Markdown para um projeto (módulo Auto-docs).bearer
GET·POST/v1/merchant/configA configuração do módulo merchant (chatbot de atendimento).bearer
Marketing e analytics
POST/v1/marketing/generateGera conteúdo orgânico para redes sociais a partir de um briefing.install
GET·POST/v1/marketing/configA configuração do módulo de marketing (marca, plataformas).bearer
POST/v1/marketing/analyzeAnalisa uma marca/briefing para direcionar o conteúdo.bearer
POST/v1/marketing/mediaGera mídia de marketing (imagem) para uma publicação.bearer
POST/v1/marketing/schedule/enqueueEnfileira uma publicação agendada para publicar depois.install
GET/v1/marketing/platformsPlataformas de marketing/anúncios conectadas + seus status.bearer
GET·POST/v1/marketing/oauth/startInicia o OAuth de uma plataforma de marketing (fluxo no navegador com state assinado).público
GET/v1/marketing/oauth/callbackCallback de OAuth de uma plataforma de marketing.público
POST/v1/marketing/oauth/disconnectDesconecta uma plataforma de marketing.bearer
POST/v1/marketing/ga4/connectConecta o GA4 (Measurement ID + Property ID, segredo da MP API opcional) para eventos no servidor.bearer
POST/v1/marketing/publishPublica conteúdo em uma plataforma conectada.bearer
GET/v1/marketing/reportMétricas de campanha ao vivo (gasto/cliques/conversões) para o cliente.bearer
GET/v1/marketing/performanceDesempenho diário dos anúncios + tráfego do site (GA4) + o cruzamento do tráfego pago, em uma resposta.bearer
GET·POST/v1/marketing/ads/listLista campanhas de anúncios (Google/Meta).bearer
POST/v1/marketing/ads/statusPausa/ativa uma campanha de anúncios.bearer
POST/v1/marketing/ads/budgetDefine o orçamento de uma campanha de anúncios.bearer
POST/v1/marketing/gtm/connectArmazena um id de contêiner GTM padrão da conta ou por projeto (injeção de snippet interina).bearer
POST/v1/marketing/gtm/oauth/startInicia o OAuth da API do Tag Manager (escopos de edição + publicação) → uma URL de consentimento.bearer
GET/v1/marketing/gtm/oauth/callbackCallback de OAuth do Tag Manager (navegador, state assinado) — guarda o token no cofre.público
GET/v1/marketing/gtm/containersA árvore conta → contêiner → workspace conectada (vazia + connected:false quando não há token).bearer
POST/v1/marketing/gtm/oauth/disconnectDesconecta a API do Tag Manager (descarta os tokens) MANTENDO a conexão por ID de contêiner (snippet).bearer
GET/v1/marketing/gtm/containerO que JÁ existe em um workspace — suas tags, acionadores e variáveis (a visão do contêiner).bearer
POST/v1/marketing/gtm/tags/planA Anna planeja um conjunto de tags (config do GA4 + eventos, pixel do Meta opcional) e guarda uma revisão.bearer
GET/v1/marketing/gtm/reviewA revisão de tags armazenada (por ?reviewId= ou ?projectId=), com a decisão de cada item.bearer
POST/v1/marketing/gtm/review/decideAprova/rejeita uma tag proposta.bearer
POST/v1/marketing/gtm/tags/applyCria as tags APROVADAS (+ acionadores/variáveis), gera uma versão e publica. Simulação (dry-run) a menos que MKT_GTM_PUBLISH_LIVE esteja armado.bearer
POST/v1/marketing/meta/test-callsEvidência para App Review: uma chamada Graph por permissão do Instagram/Facebook. Somente leitura por padrão.bearer
Agenda (calendário)
GET/v1/agenda/connectInicia o OAuth do Google Calendar.bearer
GET/v1/agenda/callbackCallback de OAuth do Google Calendar.público
GET/v1/agenda/statusStatus da conexão do calendário.bearer
POST/v1/agenda/disconnectDesconecta o calendário.bearer
GET·POST/v1/agenda/configConfiguração do módulo Agenda.bearer
GET/v1/agenda/calendarsLista os calendários da conta conectada.bearer
GET/v1/agenda/eventsPróximos eventos de um calendário.bearer
POST/v1/agendaO relay público da agenda (instalação do módulo).install
Canais de mensagens
GET/v1/channels/statusStatus da conexão do canal de mensagens.bearer
POST/v1/channels/connectConecta um canal de mensagens.bearer
POST/v1/channels/disconnectDesconecta um canal.bearer
POST/v1/channels/testEnvia uma mensagem de teste no canal.bearer
GET·POST/v1/channels/meta/webhookVerificação + recebimento do webhook do Meta (WhatsApp/Instagram/Messenger).público
GET·POST/v1/channels/threads/webhookVerificação + recebimento do webhook do Threads (respostas, menções). App, segredo e formato de payload separados do Meta.público
Conta e autenticação
POST/account/api/registerCadastro por convite → cookie de sessão.público
POST/account/api/loginLogin por senha (retorna um desafio de 2FA quando cadastrado).público
POST/account/api/login/2faConclui um login protegido por 2FA (verifica o segundo fator).público
POST/account/api/logoutEncerra a sessão.sessão
GET/account/api/meO perfil logado + cobrança/pacotes.sessão
GET/account/api/usageO resumo de uso do período (requisições/tokens/créditos).sessão
GET/account/api/2faStatus da verificação em duas etapas (ativada/método).sessão
POST/account/api/2fa/totp/startInicia o cadastro do autenticador (TOTP) → segredo + URL otpauth.sessão
POST/account/api/2fa/totp/confirmConfirma o cadastro do TOTP com um código → 2FA ativada.sessão
POST/account/api/2fa/email/startInicia o cadastro de código por e-mail (recusado quando o envio de e-mail está indisponível).sessão
POST/account/api/2fa/email/confirmConfirma o cadastro de código por e-mail → 2FA ativada.sessão
POST/account/api/2fa/disableDesativa a verificação em duas etapas.sessão
POST/account/api/prefsPreferências de apresentação (experiência/autonomia/profundidade de revisão).sessão
POST/account/api/change-passwordAltera a sua senha.sessão
POST/account/api/forgot-passwordInicia uma redefinição de senha autoatendida (sem enumeração).público
GET/account/api/downloadsManifesto de downloads de instaladores com acesso controlado.sessão
GET/account/api/notificationsSuas notificações no app (ex.: um projeto compartilhado com você); ?unread=1 filtra.sessão
POST/account/api/notifications/readMarca notificação(ões) como lida(s) (por id, ou todas).sessão
Cobrança, arquivos e armazenamento
GET/v1/packsPacotes de recarga de créditos (com preço por país).público
POST/v1/checkoutInicia um checkout no Stripe para um pacote de créditos.bearer
GET/v1/storageUso do armazenamento em nuvem + cota/preço.bearer
GET·POST/v1/filesArquivos em nuvem da conta (listar/gravar).bearer
GET/v1/files/downloadBaixa um arquivo em nuvem da conta.bearer
GET·POST·DELETE/v1/files/folderUpload de pasta: política + lote + retomada.bearer
GET/v1/reportRelatório de uso em texto puro.bearer
Ajuda e documentação
GET/v1/helpA central de ajuda do produto (artigos categorizados + changelog).público
GET/docs/apiEsta referência de API (adicione ?format=json para a tabela legível por máquina).público
GET/v1/door/manifestDescrições e esquemas de argumentos das ferramentas do plugin de editor, para que uma instalação atualize seus próprios textos sem baixar de novo.público
GET/config.jsonConfiguração de runtime que o cliente lê (env, versão, opções de modelo).público
GET/healthzSonda de liveness.público
Admin (operador)
POST/admin/api/users/project-buildLê os arquivos construídos de um usuário (depuração do operador).admin
POST/admin/api/users/project-seedSemeia um build inteiro de projeto a partir de um manifesto (recuperação).admin
POST/admin/api/users/project-reconcile-statusConverte um rascunho que já tem build para live (o reparo do proj-2).admin
POST/admin/api/projects/copyCopia um projeto (registro + build) para outra conta.admin
Nos editores
Você não precisa chamar a API na mão para usar a Anna em um editor: o Anna Connect registra o servidor MCP anna-brain no Claude Code, Claude Desktop, Cursor, Windsurf, VS Code (modo agente do Copilot), Zed e o Codex CLI — mais um trecho para colar no JetBrains, e a IA do seu editor passa a chamar as ferramentas da Anna direto.