API do August
O August disponibiliza uma API REST pública em https://app.august.law/api/v1. As solicitações e respostas usam JSON simples, então você pode criar integrações com o August a partir de qualquer cliente HTTP.
A especificação OpenAPI está publicada em https://app.august.law/api/v1/openapi.json. Ela é compatível com OpenAPI 3.1, tem o título "August Public API" e pode ser lida sem autenticação. Carregue-a em qualquer visualizador de OpenAPI (Swagger UI, Redoc, Scalar), no Postman ou em um gerador de clientes para explorar todos os endpoints. A URL de servidores da especificação corresponde ao host que a forneceu, portanto os clientes gerados usam automaticamente o host correto.
Autenticação
Cada solicitação envia uma chave de API do August como um token bearer:
Authorization: Bearer ak_...Crie chaves em configurações da conta do August > API Keys. As chaves começam com ak_ e devem ter escopo de usuário; chaves com escopo de organização são rejeitadas com o erro API key must be scoped to a user, not an organization. As chamadas são executadas como esse usuário e mostram apenas o que esse usuário pode acessar no August. Uma chave ausente ou inválida retorna HTTP 401 com um corpo JSON como {"message":"UNAUTHORIZED","code":"UNAUTHORIZED"}.
Trate as chaves de API como segredos. Se uma chave for exposta, revogue-a e crie uma nova.
Início rápido
Esta solicitação lista os projetos aos quais o usuário da chave pode acessar:
curl https://app.august.law/api/v1/projects -H "Authorization: Bearer ak_your_key"Endpoints
Leia a especificação OpenAPI para obter a lista completa de endpoints e seus parâmetros: o August atualiza a API ao longo do tempo, e a especificação sempre reflete o estado mais recente. Carregue-a em um visualizador ou gerador de clientes e trabalhe a partir dela, em vez de usar uma lista estática.
Para ver um exemplo completo de como executar um agente pela API, consulte Acionar uma execução de agente pela API.
Operações de longa duração
As consultas de chat e as execuções de agentes são assíncronas: a solicitação inicial retorna um ID imediatamente, e você consulta o endpoint de status ou de execução até que o resultado esteja pronto. As consultas de chat também podem ser canceladas. A especificação mostra as operações exatas para iniciar, consultar, obter resultados e cancelar.
Usando o August a partir de um cliente de IA
As mesmas operações públicas também são disponibilizadas como ferramentas MCP em /api/mcp, portanto um cliente MCP pode chamar o August diretamente. Consulte August MCP.