API de August
August expone una API REST pública en https://app.august.law/api/v1. Las solicitudes y respuestas utilizan JSON sin formato, por lo que puedes integrar August desde cualquier cliente HTTP.
La especificación de OpenAPI se publica en https://app.august.law/api/v1/openapi.json. Es OpenAPI 3.1, tiene el título "August Public API" y se puede leer sin autenticación. Cárgala en cualquier visor de OpenAPI (Swagger UI, Redoc, Scalar), Postman o generador de clientes para explorar todos los endpoints. La URL de los servidores de la especificación coincide con el host que la sirvió, por lo que los clientes generados apuntan automáticamente al host correcto.
Autenticación
Cada solicitud envía una clave de API de August como token de portador:
Authorization: Bearer ak_...Crea claves en la configuración de la cuenta de August, en > Claves de API. Las claves comienzan por ak_ y deben estar vinculadas a un usuario; las claves vinculadas a una organización se rechazan con el error API key must be scoped to a user, not an organization. Las llamadas actúan como ese usuario y solo pueden acceder a lo que ese usuario puede ver en August. Una clave ausente o no válida devuelve HTTP 401 con un cuerpo JSON como {"message":"UNAUTHORIZED","code":"UNAUTHORIZED"}.
Trata las claves de API como secretos. Si una clave queda expuesta, revócala y crea una nueva.
Inicio rápido
Esta solicitud muestra los proyectos a los que el usuario de la clave puede acceder:
curl https://app.august.law/api/v1/projects -H "Authorization: Bearer ak_your_key"Endpoints
Consulta la especificación de OpenAPI para ver la lista completa de endpoints y sus parámetros: August actualiza la API con el tiempo y la especificación siempre refleja el estado más reciente. Cárgala en un visor o generador de clientes y trabaja a partir de ahí, en lugar de usar una lista estática.
Para ver un ejemplo práctico de cómo ejecutar un agente mediante la API, consulta Activar una ejecución de agente desde la API.
Operaciones de larga duración
Las consultas de chat y las ejecuciones de agentes son asíncronas: la solicitud inicial devuelve inmediatamente un ID y debes consultar el endpoint de estado o de ejecución hasta que el resultado esté listo. Las consultas de chat también se pueden cancelar. La especificación muestra las operaciones exactas para iniciar, consultar el estado, obtener resultados y cancelar.
Usar August desde un cliente de IA
Las mismas operaciones públicas también se exponen como herramientas de MCP en /api/mcp, por lo que un cliente MCP puede llamar directamente a August. Consulta August MCP.