SUsurrealdb

GET /api/v1/{context_id}/audit

Changed on

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

Request

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

  • 9f1598713067Revision changes
    • info

      added the new optional query request parameter cursor

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status