v1

latestOpenAPI 3.1.0BUSL-1.12026-07-1756132288.0 KB

Audit view over the trace graph. Returns recent traces with principal/key/time/kind filters.

get/api/v1/{context_id}/audit

Path parameters

context_idstring required

Spectron context id

Query parameters

principalstring

Filter by principal (api-key id)

keystring

Alias for principal

kind'decision' | 'retrieval' | 'response'

The trace kind discriminant — a closed three-value set over the trace tables. Serialises to decision / retrieval / response so the /audit wire shape and the kind= filter stay locked to the enum and can't drift (typos are rejected, the match arms are exhaustive, and the OpenAPI schema enumerates the allowed values).

Trace kind filter: decision|retrieval|response

sincestring

Inclusive lower bound on created_at (RFC 3339)

untilstring

Inclusive upper bound on created_at (RFC 3339)

limitinteger

Max rows to return (default 50, max 500)

Response