# Hermes Publisher API > API operacional do Hermes Studio para inteligência editorial, criação, fluxo de aprovação, equipe e conexões sociais. Version: 1.3.0 Release date: 2026-08-22 Base URL: https://socialmedia.janvalellam.com.br MCP Streamable HTTP: https://socialmedia.janvalellam.com.br/api/mcp Canonical OpenAPI: https://socialmedia.janvalellam.com.br/api/ai/openapi.yaml ## Authentication and safety - Send `Authorization: Bearer ` only to routes marked as authenticated. Normal protected routes accept an active Supabase session or an `hms_live_` personal token. - Routes marked `session only` accept only a Supabase session. Personal tokens cannot create/reveal tokens, administer access, manage members, or start/disconnect OAuth connections. - Supabase Studio sessions receive capabilities exclusively from the member `access_level` role. `api_access_level` never limits or disables a Studio session. - Only personal tokens use the individual API level. They are hash-only on the server, expire in 1–90 days, reveal their secret once, and are limited by token scopes plus `api_access_level` plus the current Studio role ceiling. - Personal-token API levels are `nenhum`, `leitor`, `criador`, `lider`, and `admin`; changing them affects PATs immediately without changing Studio-session permissions. - The credential must belong to an active `team_members` record. Capabilities are enforced by the server and authorization activity is audited without request bodies or secrets. - Use `api_revision`/`updated_at` as opaque CAS tokens and `Idempotency-Key` when the operation supports it. - Never send or store provider credentials, service-role keys, `.env` contents, temporary passwords, or access tokens in prompts/logs. - Read the exact current object before a mutation. Destructive, publishing, permission, and external actions require explicit user intent. - MCP tools are an explicit allowlist; never use them to bypass route capabilities or validation. ## Operations - `GET /api/access/audit` — Consultar a trilha de auditoria da API (Supabase session; capability: team_admin) - `GET /api/access/catalog` — Consultar o catálogo de rotas e ferramentas MCP (Central da API) (Supabase session; capability: team_admin) - `GET /api/access/me` — Consultar o próprio acesso individual à API (Supabase session) - `GET /api/access/members` — Listar acessos individuais da equipe (Supabase session; capability: team_admin) - `PATCH /api/access/members/{memberId}` — Alterar o nível individual de API de um membro (Supabase session; capability: team_admin) - `DELETE /api/access/members/{memberId}/tokens/{tokenId}` — Revogar um token pessoal como administrador (Supabase session; capability: team_admin) - `GET /api/access/tokens` — Listar os próprios tokens pessoais (Supabase session) - `POST /api/access/tokens` — Criar um token pessoal com escopo e expiração (Supabase session) - `DELETE /api/access/tokens/{tokenId}` — Revogar um token pessoal próprio (Supabase session) - `GET /api/ai/SKILL.md` — Baixar a skill operacional do Hermes (public) - `GET /api/ai/chatgpt.md` — Baixar instruções para ChatGPT (public) - `GET /api/ai/claude.md` — Baixar instruções para Claude (public) - `GET /api/ai/cursor.mdc` — Baixar regras do Cursor (public) - `GET /api/ai/hermes.mjs` — Baixar a CLI Hermes (public) - `GET /api/ai/llms-full.txt` — Baixar a referência completa para LLMs (public) - `GET /api/ai/llms.txt` — Baixar o índice conciso para LLMs (public) - `GET /api/ai/manifest.json` — Baixar o manifesto verificável dos artefatos (public) - `GET /api/ai/mcp-setup.md` — Baixar instruções de conexão MCP (public) - `GET /api/ai/openapi.json` — Baixar o contrato OpenAPI 3.1 (public) - `GET /api/ai/openapi.yaml` — Baixar o contrato OpenAPI 3.1 em YAML (public) - `GET /api/ai/postman.json` — Baixar a coleção Postman gerada (public) - `GET /api/ai/skill.zip` — Baixar a skill completa e instalável (public) - `GET /api/anexaveis` — Listar eventos que aceitam mídia do membro (session or personal token; capability: art) - `GET /api/aprovacoes` — Listar conteúdos aguardando aprovação (session or personal token; capability: approve) - `POST /api/aprovar` — Aprovar ou recusar conteúdo (session or personal token; capability: approve) - `POST /api/art` — Gerar e armazenar uma arte (session or personal token; capability: art) - `POST /api/carousel` — Gerar carrossel com até dez cards (session or personal token; capability: carousel) - `GET /api/config` — Ler configuração versionada (session or personal token; capability: config_view) - `POST /api/config` — Criar nova versão de uma configuração (session or personal token; capability: config) - `GET /api/config/log` — Listar histórico de configurações (session or personal token; capability: config) - `POST /api/demanda` — Criar demanda editorial (session or personal token; capability: tasks_assign) - `POST /api/draft` — Salvar rascunho editorial (session or personal token; capability: draft_save) - `GET /api/email-drafts` — Listar metadados de rascunhos de e-mail (session or personal token; capability: email_drafts_view) - `DELETE /api/email-drafts/{templateId}` — Excluir exatamente um rascunho com CAS (session or personal token; capability: delete) - `GET /api/email-drafts/{templateId}` — Consultar um rascunho de e-mail (session or personal token; capability: email_drafts_view) - `PUT /api/email-drafts/{templateId}` — Criar ou atualizar um rascunho com CAS (session or personal token; capability: email_drafts_edit) - `POST /api/enviar` — Enviar conteúdo para aprovação (session or personal token; capability: enviar) - `GET /api/health` — Consultar saúde do serviço (public) - `GET /api/insights/horarios` — Consultar melhores horários de publicação (session or personal token; capability: analytics) - `POST /api/jornada/eventos` — Receber eventos do checkout (servidor a servidor) (session or personal token) - `POST /api/jornada/lead` — Resumo de um lead para o SiteUP CRM (compras, origem e páginas) (session or personal token) - `POST /api/jornada/perfil` — Consultar o perfil de uma pessoa pelo e-mail (dado pessoal, só Financeiro) (session or personal token; capability: vendas) - `POST /api/jornada/ses` — Receber eventos de e-mail do SES (SNS) (session or personal token) - `POST /api/jornada/sincronizar` — Sincronizar a linha do tempo (session or personal token; capability: config) - `GET /api/lancamentos` — Listar os lançamentos com dashboard (session or personal token; capability: vendas) - `PUT /api/lancamentos/{projetoId}` — Cadastrar ou editar o dashboard de um projeto (session or personal token; capability: config) - `GET /api/lancamentos/{projetoId}/compradores` — Listar os compradores de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/decisao` — Consultar o painel de decisão de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/disparos` — Consultar os disparos de WhatsApp de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/funil` — Consultar o funil do CRM de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/jornada` — Consultar o funil da linha do tempo de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/midia` — Consultar a mídia paga de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/origem` — Consultar a origem das vendas de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/perfis` — Consultar os perfis agregados de quem mexeu num lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/resumo` — Consultar o painel de um lançamento (session or personal token; capability: vendas) - `GET /api/lancamentos/{projetoId}/saude` — Consultar a saúde de um lançamento (session or personal token; capability: vendas) - `POST /api/mcp` — Chamar o MCP Streamable HTTP do Hermes (session or personal token) - `GET /api/me` — Consultar membro autenticado e capacidades (session or personal token) - `GET /api/membros` — Listar membros ativos (Supabase session; capability: members) - `PATCH /api/membros` — Alterar nível de acesso ou permissão financeira (Supabase session; capability: members) - `POST /api/membros` — Convidar um novo membro (Supabase session; capability: members) - `DELETE /api/membros/{memberId}` — Revogar acesso e limpar atribuições atuais (Supabase session; capability: members) - `POST /api/membros/{memberId}/senha` — Definir senha nova para um membro (Supabase session; capability: members) - `POST /api/orbum/cancelamentos` — Registrar o motivo de saída de um assinante do Orbum (session or personal token; capability: vendas) - `GET /api/orbum/resumo` — Consultar o painel da assinatura Orbum (session or personal token; capability: vendas) - `GET /api/orbum/saidas` — Listar quem está saindo do Orbum (session or personal token; capability: vendas) - `GET /api/plataformas/{platformId}/senha` — Ler a senha de uma plataforma (Supabase session; capability: team_admin) - `PUT /api/plataformas/{platformId}/senha` — Gravar ou apagar a senha de uma plataforma (Supabase session; capability: team_admin) - `GET /api/projects` — Listar projetos colaborativos (session or personal token; capability: projects_view) - `POST /api/projects` — Criar projeto colaborativo vazio (session or personal token; capability: projects_manage) - `GET /api/projects/{projectId}` — Consultar um projeto e seu token CAS (session or personal token; capability: projects_view) - `GET /api/projects/{projectId}/operations` — Listar histórico de operações do projeto (session or personal token; capability: projects_audit_view) - `POST /api/projects/{projectId}/operations` — Aplicar uma operação semântica com CAS (session or personal token; capability: projects_edit by default; projects_manage according to the documented operation type) - `POST /api/rag` — Buscar contexto e citações no Cérebro (session or personal token; capability: rag) - `POST /api/reels` — Iniciar geração assíncrona de vídeo (session or personal token; capability: video) - `GET /api/reels/{id}` — Consultar uma geração de vídeo (session or personal token; capability: reels_view) - `POST /api/roteiro` — Gerar roteiro com pesquisa e verificação (session or personal token; capability: roteiro) - `GET /api/skills` — Listar skills publicadas (session or personal token; capability: skills_view) - `POST /api/skills` — Publicar nova versão de uma skill (session or personal token; capability: config) - `GET /api/tarefas` — Listar tarefas ativas do membro (session or personal token; capability: tasks_view) - `POST /api/upload` — Enviar arquivo pronto (session or personal token; capability: art) - `GET /api/vendas/comercial` — Consultar as vendas do time comercial e a comissão (session or personal token; capability: vendas) - `GET /api/vendas/resumo` — Consultar o resumo de vendas do período (session or personal token; capability: vendas) - `GET /media/{id}` — Baixar uma mídia pelo domínio do Hermes (public) - `GET /oauth/_accounts` — Listar provedores e contas conectadas (session or personal token; capability: connections_view) - `GET /oauth/tiktok/creator-info` — Consultar restrições do criador no TikTok (session or personal token; capability: connections_view) - `POST /oauth/tiktok/publish` — Publicar conteúdo no TikTok (session or personal token; capability: publish) - `GET /oauth/{provider}/callback` — Concluir callback OAuth (public) - `POST /oauth/{provider}/disconnect` — Desconectar um provedor social (Supabase session; capability: connections) - `POST /oauth/{provider}/start` — Iniciar autorização OAuth (Supabase session; capability: connections) - `GET /oauth/{provider}/status` — Exibir diagnóstico HTML da conexão (session or personal token; capability: connections_view) ## Generated artifacts - https://socialmedia.janvalellam.com.br/api/ai/SKILL.md — Baixar a skill operacional do Hermes. - https://socialmedia.janvalellam.com.br/api/ai/chatgpt.md — Baixar instruções para ChatGPT. - https://socialmedia.janvalellam.com.br/api/ai/claude.md — Baixar instruções para Claude. - https://socialmedia.janvalellam.com.br/api/ai/cursor.mdc — Baixar regras do Cursor. - https://socialmedia.janvalellam.com.br/api/ai/hermes.mjs — Baixar a CLI Hermes. - https://socialmedia.janvalellam.com.br/api/ai/llms-full.txt — Baixar a referência completa para LLMs. - https://socialmedia.janvalellam.com.br/api/ai/llms.txt — Baixar o índice conciso para LLMs. - https://socialmedia.janvalellam.com.br/api/ai/manifest.json — Baixar o manifesto verificável dos artefatos. - https://socialmedia.janvalellam.com.br/api/ai/mcp-setup.md — Baixar instruções de conexão MCP. - https://socialmedia.janvalellam.com.br/api/ai/openapi.json — Baixar o contrato OpenAPI 3.1. - https://socialmedia.janvalellam.com.br/api/ai/openapi.yaml — Baixar o contrato OpenAPI 3.1 em YAML. - https://socialmedia.janvalellam.com.br/api/ai/postman.json — Baixar a coleção Postman gerada. - https://socialmedia.janvalellam.com.br/api/ai/skill.zip — Baixar a skill completa e instalável.