Skip to main content
A report is an AI-written vulnerability write-up: impact, steps, proof of concept, and references. Aquila queues the generation, writes the draft, and lets you edit the result.

​
Queue a report

POST /api/reports with the finding reference:
  • 201 — Aquila queued the report.
  • 200 — a report already exists for the finding. The response carries it.
  • 404 — unknown finding.

​
Track generation

  • GET /api/reports — paginated list. ?status= filters by state, and ?vulnerabilityId= narrows to one finding.
  • POST /api/reports/{id}/retry — queue generation again. Returns 409 while a generation is already running.

​
Edit the content

PATCH /api/reports/{id}/content replaces the report body:
Returns 409 when a generation is writing the same report. PUT and PATCH on /api/reports/{id} return 405. Edits go through the content endpoint.

​
Delete

DELETE /api/reports/{id} deletes the report. The finding stays.