Events

REST endpoints for events. Bearer-auth required.

GET /api/events

List events.

Query parameters

limit (optional): Page size (1–100, default 100).
after (optional): Keyset cursor — return the page after this row (next page).
before (optional): Keyset cursor — return the page before this row (prev page).
ids (optional): Comma-separated list of IDs. Narrows results to these IDs within the caller's accessible scope (does not bypass access checks).
filter (optional): Nested filter expression (<Entity>Filter): AND/OR/NOT + per-field comparison operators + relation traversal. JSON-encoded on the query string.
orderBy (optional): Multi-key sort (<Entity>OrderBy[]): array of { field: direction } applied in order. Directions: asc/desc plus the four explicit nulls variants. JSON-encoded on the query string.
workspace_id (optional): Filter events to this workspace.
type (optional): Filter by event type (e.g. 'agent.created').
subject_id (optional): Filter to events whose subject is the given entity ID.
parent_id (optional): Filter to events that are children of this parent event.
created_at_after (optional): ISO date — return only events created at or after this time.
created_at_before (optional): ISO date — return only events created at or before this time.
user_id (optional): Shorthand: filter where userId equals this value.

Response

JSON

{
  "data": [
    {
      "id": "<...>",
      "type": "<...>",
      "subjectId": "<...>",
      "userId": "<...>",
      "workspaceId": "<...>",
      "parentId": "<...>",
      "data?": "<...>",
      "createdAt": "<...>"
    }
  ],
  "pageInfo": {
    "total": "number",
    "hasNextPage": "boolean",
    "hasPreviousPage": "boolean",
    "startCursor": "string",
    "endCursor": "string"
  }
}

GET /api/events/{id}

Get an event by ID.

Path parameters

id (required): Event to retrieve.

Response

JSON

{
  "id": "string",
  "type": "agent.created | agent.deleted | agent.purged | agent.restored",
  "subjectId": "string",
  "userId": "string",
  "workspaceId": "string",
  "parentId": "string",
  "data?": "any",
  "createdAt": "string"
}