API di August
August espone un'API REST pubblica all'indirizzo https://app.august.law/api/v1. Le richieste e le risposte usano JSON semplice, quindi puoi basarti su August da qualsiasi client HTTP.
La specifica OpenAPI è pubblicata all'indirizzo https://app.august.law/api/v1/openapi.json. È OpenAPI 3.1, ha il titolo "August Public API" ed è consultabile senza autenticazione. Caricala in qualsiasi visualizzatore OpenAPI (Swagger UI, Redoc, Scalar), in Postman o in un generatore di client per esplorare ogni endpoint. L'URL servers della specifica corrisponde all'host che l'ha fornita, quindi i client generati scelgono automaticamente l'host corretto.
Autenticazione
Ogni richiesta invia una chiave API di August come token bearer:
Authorization: Bearer ak_...Crea le chiavi nelle impostazioni dell'account August > API Keys. Le chiavi iniziano con ak_ e devono essere associate a un utente; le chiavi associate a un'organizzazione vengono rifiutate con l'errore API key must be scoped to a user, not an organization. Le chiamate agiscono per conto dell'utente e mostrano solo ciò a cui tale utente può accedere in August. Una chiave mancante o non valida restituisce HTTP 401 con un corpo JSON simile a {"message":"UNAUTHORIZED","code":"UNAUTHORIZED"}.
Tratta le chiavi API come segreti. Se una chiave viene esposta, revocala e creane una nuova.
Avvio rapido
Questa richiesta elenca i progetti a cui l'utente associato alla chiave può accedere:
curl https://app.august.law/api/v1/projects -H "Authorization: Bearer ak_your_key"Endpoint
Consulta la specifica OpenAPI per l'elenco completo degli endpoint e dei relativi parametri: August aggiorna l'API nel tempo e la specifica riflette sempre lo stato più recente. Caricala in un visualizzatore o in un generatore di client e parti da lì, invece di usare un elenco statico.
Per un esempio pratico di esecuzione di un agent tramite l'API, consulta Attivare un'esecuzione di un agent dall'API.
Operazioni di lunga durata
Le query chat e le esecuzioni degli agent sono asincrone: la richiesta iniziale restituisce immediatamente un ID e devi interrogare l'endpoint di stato o di esecuzione finché il risultato non è pronto. Le query chat possono anche essere annullate. La specifica mostra le operazioni esatte per avviare, interrogare, recuperare i risultati e annullare.
Usare August da un client IA
Le stesse operazioni pubbliche sono esposte anche come strumenti MCP in /api/mcp, quindi un client MCP può chiamare direttamente August. Consulta August MCP.