> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attaxr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reports

> Queue, track, and edit AI-written vulnerability reports.

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:

```json theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
{ "vulnerabilityId": "vuln_..." }
```

* `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:

```json theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
{ "content": "# Impact\n\n..." }
```

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.