API reference/Automation/Events

GETLive

List events

The caller-wide, append-only event feed: pipeline activity plus an attributed audit entry for every /v1 write.

/v1/events

Authorization

Credential

oauth_user

Required scopes

applications:read

Implementation note

Cursor-paginated newest first: ?limit=, ?cursor=, ?updatedAt.gt= (filters createdAt — events are immutable). Filters: ?targetType=, ?type= (e.g. api.write), ?actor= (e.g. "pat:capture-hook" or "oauth:<clientId>"). "What changed since my last run" is one call; type=api.write per actor is the "what did my agent change" audit trail (ENG-682).

Error responses

400Invalid request

The request body was missing, malformed, or failed schema validation. Field-level problems are listed under `issues`.

401Authentication required

No valid credentials were supplied. Attach a Bearer access token and retry.

402Upgrade required

The authenticated user's plan does not include this capability. `feature` names the gated capability, `requiredPlan` the cheapest plan that unlocks it, `currentPlan` the user's plan today, and `upgradeUrl` links to checkout. This is a plan gate, not a transient error — retrying without upgrading fails again; surface `upgradeUrl` to the user instead. Dormant until a plan that grants the feature is active, so a route that documents it may not currently return it.

403Insufficient scope

The token is valid but lacks the OAuth scope (or token kind) this endpoint requires.