Skip to main content
GET
List events

Authorizations

x-api-key
string
header
required

SAN-issued API key (sk_…) issued from the SAN Agents Dashboard (Settings → API Keys). Used by every /api/v1/* endpoint; usage is billed in credits against the owning account's active Stripe subscription.

Path Parameters

ref
string
required

Flexible agent identifier. Accepts any of:

  • UUID — 488ed3ff-6a4d-42e5-8e24-44eeef77959c
  • Name (case-insensitive) — Noah, noah, NOAH
  • Slug — lowercase name with spaces as underscores
  • External ID — 017, 17, 069, 69 (# and zero-padding tolerated)

Query Parameters

limit
integer
default:10

Max number of events to return.

Required range: 1 <= x <= 30

Response

OK — recent canonical events for the agent.

agent
object
required
count
integer
required
events
object[]
required