Agents - Aquila

Aquila records every agent run as a session. A session groups the execution events of one run, so you can replay what the agent did and when.

List sessions

GET /api/agents returns the paginated session list. ?scanId= narrows the list to one scan.

Read the timeline

GET /api/agents/{id}/events returns the chronological execution events for one session: tool calls, streamed output, and results. The chat canvas reads this endpoint to render a live timeline.

Manage sessions

GET /api/agents/{id} — one session.
DELETE /api/agents/{id} — delete a session.
POST /api/agents/stop — stop running sessions.
POST /api/agents/bulk-delete — delete many sessions.

Stop and bulk-delete need the owner or admin role. Both take an id list:

{ "ids": ["run_1", "run_2"] }

Sessions belong to their owner. List, get, and delete return 404 for ids that belong to another user.