API Reference
Events API
Query the immutable event log for your workspace.
Overview
Events are append-only records of everything that has happened to resources in your workspace. You can query them for audit trails, debugging, and building reactive systems.
List events
GET /v1/eventsQuery parameters
| Parameter | Type | Description |
|---|---|---|
resourceId | string | Filter events for a specific resource |
type | string | Filter by event type (e.g. resource.created) |
from | ISO 8601 | Start of time range |
to | ISO 8601 | End of time range |
limit | integer | Results per page (default: 20, max: 100) |
cursor | string | Pagination cursor |
Response
{
"data": [
{
"id": "evt_01j...",
"type": "resource.created",
"resource_id": "res_01j...",
"payload": { ... },
"occurred_at": "2025-01-01T00:00:00Z"
}
],
"meta": {
"nextCursor": "cursor_...",
"hasMore": false
}
}Get event
GET /v1/events/:idResponse
{
"data": {
"id": "evt_01j...",
"type": "resource.updated",
"resource_id": "res_01j...",
"payload": {
"before": { "name": "Jane" },
"after": { "name": "Jane Doe" }
},
"occurred_at": "2025-01-01T00:00:00Z"
}
}Event types
| Type | Description |
|---|---|
resource.created | A new resource was created |
resource.updated | A resource's fields were changed |
resource.deleted | A resource was deleted |
integration.connected | An integration was enabled |
integration.disconnected | An integration was disabled |
Events cannot be created, updated, or deleted through the API. They are written automatically by the platform.