Skip to content

GET /api/v1/entities/{name}/{guid}/audit

Status: GA Access: token required API contract: 0.3.0 · capability 2026-09-03.1 View as Markdown Open in Claude Open in ChatGPT

Read Audit

Audit trail for one row, projected from lifecycle_log.

Latest first. A multi-field edit is expanded into one event per field.

Auth: Authorization: Bearer <token> required

Terminal window
curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/entities/<name>/<guid>/audit" \
-H "Authorization: Bearer <token>"

The contract carries no example for this response; schema: array of AuditEvent. Field-level shape: interactive explorer.

array of AuditEvent — Successful Response

FieldTypeDescription
actionstring
actorstring
field_changedstring | null (opt.)
lcstepinteger | null (opt.)
new_valueobject (opt.)
old_valueobject (opt.)
timestampstring
ParameterInRequiredTypeDefaultConstraintsDescription
namepathyesstring——
guidpathyesinteger——
limitquerynointeger50min 1; max 500
CodeMeaningBody
401Missing or invalid authentication credentialsErrorResponse
422Validation ErrorHTTPValidationError

Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.