Sign in

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 100, max 500)

cursorstring

Continuation token from the previous page's page.nextCursor

Response

Changes

Changed in 1 of the 5 revisions of this API.3

  • 9f15987130673See the full diff
    • ○

      added the new optional query request parameter cursor

      new-optional-request-parameter

    • ○

      added the non-success response with the status 503

      response-non-success-status-added

    • ○

      added the required property page to the response with the 200 status

      response-required-property-added