Startvex API

Retorna o plano efetivo da conta, limites, consumo atual e permissoes de acao. A API permanece como autoridade final para cada limite suportado.

Cria uma categoria reutilizavel para organizar endpoints gerenciados da API. Exige super_admin.

Exclui uma categoria de endpoints da API somente quando nenhum endpoint gerenciado estiver associado a ela. Exige super_admin.

Lista dúvidas e pedidos de ajuste de endpoints com responsáveis, respostas, datas e estados. Exige super_admin.

Registra resposta, reabre ou finaliza uma dúvida ou ajuste, preservando responsáveis, datas e evento de histórico. Exige super_admin.

Envia o contexto administrativo do endpoint à OpenAI, registra a resposta gerada e move exclusivamente o item de pending para responded. Exige super_admin.

Returns the endpoint catalog, operational classifications and totalizers, including active endpoints visible in the public documentation. Requires super_admin.

Move os endpoints selecionados para uma categoria ou remove a categoria de todos eles. A operação é atômica e registra histórico e auditoria para cada endpoint efetivamente alterado. Exige super_admin.

Atualiza Função, Detalhamento, documentação das validações, validação da regra de negócios, disponibilidade, visibilidade ou categoria. Exige super_admin.

Retorna alterações de classificação, observações e usuários responsáveis. Exige super_admin.

Retorna até 50 resumos de transações recentes associadas ao endpoint. Exige super_admin.

Retorna os conteúdos da requisição e da resposta de um log de transação associado ao endpoint. Exige super_admin.

Cria um item pendente no Workflow vinculado ao endpoint e registra o solicitante e a data. Exige super_admin.

Lista as 200 transações mais recentes e permite buscar em metadados e nos conteúdos armazenados da requisição ou resposta. Exige super_admin.

Remove apenas transações catalogadas que ultrapassam as 50 mais recentes de cada endpoint. Preserva logs sem endpoint correspondente e exige super_admin.

Exibe metadados e conteúdos armazenados da requisição e resposta de uma transação. Exige super_admin.

Retorna dados de administracao de SmartCompanies para admins.

Updates SmartCompany status as an admin operation.

Retorna todas as configuracoes de fee, incluindo inativas, para admins.

Atualiza uma configuracao de fee da plataforma como operacao admin.

Informa se a rotina administrativa de cópia da produção para a homologação está habilitada. Exige super_admin.

Lista as últimas atualizações da homologação com responsável, data, status e totais disponíveis. Exige super_admin.

Apaga e recria as tabelas da homologação com estrutura e dados da produção. Exige super_admin, flag operacional, ambiente production, confirmação explícita e lock MySQL.

Lista as migrations executadas e pendentes da aplicação no ambiente atual. Exige super_admin.

Executa migrations pendentes somente quando a flag operacional estiver habilitada, o ambiente e o grupo de banco forem confirmados e o lock administrativo for adquirido. Exige super_admin.

Retorna todas as configuracoes de paginas para admins, incluindo ocultas e startvex_team.

Cria uma pagina persistida no banco e vinculos opcionais com planos. Exige super_admin.

Exclui uma pagina e todos os seus vinculos com planos. Exige super_admin.

Atualiza uma pagina persistida e seus vinculos opcionais por id, chave ou caminho. Exige super_admin.

Reconstroi read models para todos os escopos ou para um usuario/empresa especifico.

Retorna estatisticas agregadas da plataforma para usuarios admin.

Retorna todos os planos, inclusive inativos, e os IDs de paginas vinculadas. Exige super_admin.

Cria um plano com caracteristicas JSON e vinculos opcionais com paginas. Exige super_admin.

Atualiza os dados do plano e opcionalmente substitui todos os vinculos com paginas. Exige super_admin.

Retorna todos os menus do sistema para usuarios admin da Startvex.

Cria um menu personalizado do sistema. Exige super_admin.

Exclui um menu do sistema. Exige super_admin.

Atualiza um campo editavel de menu do sistema.

Retorna lancamentos de tesouraria da plataforma para admins.

Retorna dados de administracao de usuarios para admins.

Exclui ou desativa um usuario por operacao admin.

Atualiza perfil, role, plano ou status de um usuario como operacao admin.

Retorna dados administrativos de vaults de capital para admins.

Exige Bearer e Idempotency-Key. Resolve usuário, empresa, papel, função e permissões no servidor. Sem empresa usa default. Accept text/event-stream seleciona SSE; padrão JSON. Persiste mensagens, uso e auditoria.

Lista somente conversas do usuário e empresa atuais; default isola conversas sem empresa. Paginação limit de 1 a 100 e offset até 100000.

Cria conversa no contexto autenticado. Aceita título opcional e agente cadastrado no servidor.

Aplica exclusão lógica à conversa autorizada. Preserva mensagens, uso e auditoria; rejeita conversa em processamento.

Valida UUID, usuário e empresa; retorna conversa e mensagens ordenadas com estado da execução. Paginação limit e offset nas mensagens.

Altera somente title em conversa autorizada e sem execução ativa.

Uso exclusivo do AI Hub com Bearer privado e HMAC. Requer execução ativa vinculada à conversa e recarrega usuário, associação e permissões do banco. Exige edit_company; default é negado. Retorna somente id, name e sector.

Uso exclusivo do AI Hub com Bearer privado, HMAC e Idempotency-Key. A execução resolve o usuário no servidor; o Hub informa execution_id, name, symbol e, opcionalmente, tool_call_id apenas para auditoria. A autorização atual e os limites do plano são revalidados antes da criação.

Recebe um email e envia um codigo de recuperacao de 8 caracteres quando a conta ativa existe. O codigo expira em 15 minutos.

Valida no servidor o ID token emitido pelo Google. Para usuário existente, cria uma sessão autenticada; para novo usuário, retorna os dados Google para conclusão do perfil.

Retorna o client ID OAuth público configurado para inicializar o Google Identity Services no navegador.

Valida novamente o ID token Google, salva os dados complementares e cria uma conta ativa sem enviar código de ativação.

Valida as credenciais de um usuario ativo, atualiza o ultimo acesso, zera a sequencia de tentativas invalidas, gera um novo token e retorna o perfil.

Invalida o bearer token e encerra a sessao autenticada.

Valida o codigo de recuperacao de 8 caracteres, atualiza a senha e revoga as sessoes ativas do usuario.

Valida o bearer token e o email. Quando ambos pertencem a mesma sessao ativa, a API renova a sessao; se o token pertencer a outro email, a sessao e expirada.

Lista apenas blueprints privados do autor.

Cria template estrutural privado.

Exclusão lógica privada.

Consulta privada do autor.

Atualiza template privado do autor.

Exige manage_tasks e Idempotency-Key.

Cria uma intencao de investimento sandbox. Exige Idempotency-Key e pode expirar.

Armazena arquivo de evidencia em storage e retorna identificador para associacao posterior com tarefa.

Aprova a evidencia de forma atomica, emite PoB e deixa o reward pendente.

Rejeita evidencia com nota do revisor e registra o evento de status da tarefa.

Retorna posts publicos do feed, opcionalmente filtrados por parametros de consulta.

Cria um post no feed para o usuario autenticado. Exige a permissao Publicar no Pulse quando o post aponta para uma SmartCompany.

Retorna comentários públicos paginados com autor resumido.

Cria comentário autenticado de forma idempotente pelo header Idempotency-Key.

Cria de forma idempotente o like do usuário autenticado. Repetições não incrementam o contador e não removem o like.

Retorna configuracoes de fee ativas visiveis aos clientes.

Calcula uma fee usando a configuração atual, sem criar lançamento financeiro.

Retorna uma configuracao de fee pela chave.

Retorna um payload simples de status para monitoramento e verificacoes de conectividade.

Confirma um investimento sandbox, congela o snapshot de fees e emite o recibo. Exige Idempotency-Key.

Returns open, unassigned public or pool tasks grouped by company, including when the SmartCompany itself is private.

Retorna o preço ICO configurado e market cap estimado, sem variação histórica.

Retorna o preço ICO configurado para um token, sem série histórica.

Retorna notificacoes do usuario autenticado.

Marca todas as notificacoes do usuario autenticado como lidas.

Retorna paginas publicas visiveis e paginas privadas vinculadas ao plano ativo do usuario autenticado. Paginas startvex_team ficam restritas ao time Startvex.

Cria Checkout para crédito em USD. O saldo só é registrado após confirmação assinada do Stripe; requer Bearer e Idempotency-Key.

Lista pagamentos Stripe do usuário autenticado, incluindo pendentes, falhos, cancelados e confirmados. Paginação por limit (1 a 100) e offset.

Cria uma sessão de pagamento único para credit_account ou plan_purchase. Requer Bearer e Idempotency-Key. Valores e duração do plano são definidos no servidor.

Valida Stripe-Signature sobre o corpo original e aplica o pagamento uma única vez. Dispensa Bearer. Eventos não suportados são reconhecidos sem efeito financeiro.

Retorna status atual e payload de uma acao de protocolo.

Libera reward somente para gestor financeiro autorizado da SmartCompany, impedindo auto-liberação e preservando o ledger append-only.

Retorna resumos de SmartCompanies visiveis ao solicitante sem expor dados privados do core.

Cria uma SmartCompany em lifecycle SQUAD. Somente name e symbol são obrigatórios, imutáveis e únicos ignorando caixa e espaços.

Wrapper legado para POST /api/v1/smart-companies, incluindo a aplicação dos limites do plano da conta.

Retorna dados da SmartCompany usando a interface legada via POST.

Retorna resumos de SmartCompanies usando a interface legada via POST.

Remove participante usando a interface legada via POST.

Cria ou atualiza participante usando a interface legada via POST.

Atualiza os dados principais da SmartCompany usando um payload legado que pode incluir smart_company_id, sc_id ou id. Somente um Founder ou Co-Founder ativo da SmartCompany de destino está autorizado.

Leitores autorizados recebem os dados da SmartCompany; founders tambem recebem secoes de gestao.

Atualiza somente campos mutáveis. name, symbol, lifecycle e published_at são rejeitados; status active e visibility public somente podem ser definidos pela publicação.

Configurações não concedem permissões reais.

Exige manage_tasks.

Exige manage_tasks.

Exige manage_tasks.

Retorna resumo de rodadas de capital, investimentos e vaults da SmartCompany.

Encerra a rodada de capital atual conforme permissoes da SmartCompany. Exige a permissao de capital.

Cria uma rodada de capital para a SmartCompany. Exige a permissao de capital.

Registra investimento idempotente e aplica o fluxo de fee, vault, tesouraria e tokens.

Retorna investidores de uma rodada de capital da SmartCompany.

Retorna rodadas de capital sandbox. Movimentacao financeira de producao permanece desativada por feature flag.

Cria uma rodada de capital sandbox e registra auditoria. Exige Idempotency-Key.

Retorna vaults de investimentos com IDs, valores em USD, estado, rodada, investidor resumido e timestamps.

Reembolsa vault ativo de forma idempotente. Exige capital societário e bloqueia auto-refund do investidor.