Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Retrieve the full event trail for a single request over the ShoulderTap HTTP API.
GET /api/v1/audit?request_id={id}
curl "http://localhost:8776/api/v1/audit?request_id=req_01J..." \
-H "Authorization: Bearer $SHOULDERTAP_API_TOKEN"
[
{ "ts": "2026-07-20T17:00:00Z", "request_id": "req_01J...", "actor": "engine", "event": "request.received" },
{ "ts": "2026-07-20T17:00:01Z", "request_id": "req_01J...", "actor": "engine", "event": "routing.resolved", "detail": {"expert_id": "U0123ABC"} },
{ "ts": "2026-07-20T17:00:02Z", "request_id": "req_01J...", "actor": "engine", "event": "ask.sent" },
{ "ts": "2026-07-20T17:05:00Z", "request_id": "req_01J...", "actor": "U0123ABC", "event": "reply.received" },
{ "ts": "2026-07-20T17:06:00Z", "request_id": "req_01J...", "actor": "engine", "event": "proposal.created" },
{ "ts": "2026-07-20T17:10:00Z", "request_id": "req_01J...", "actor": "alice", "event": "proposal.accepted" }
]
request.received, routing.resolved, ask.sent, ask.rate_limited, ask.queued_quiet_hours, escalation.fired, reply.received, proposal.created, proposal.accepted, and expert.muted. An unknown request id returns an empty array.