API v1API reference
Read workspace events
Read a bounded event page for the selected workspace. Persist the returned cursor only after processing each event successfully; events never grant access outside the approved workspace.
GET
/v1/eventsAuthorization
bearerKey AuthorizationBearer <token>
A scoped automation key authorized for the REST API.
In: header
Query Parameters
cursor?string
Length
length <= 256limit?integer
Range
1 <= value <= 100Default
50Header Parameters
X-Ndnci-Workspace*string
Select a workspace explicitly included in this access grant.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/events" \ -H "X-Ndnci-Workspace: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer <NDNCI_API_KEY>"{ "success": true, "code": "PUBLIC_EVENTS_LIST", "message": "Successful response", "data": { "items": [ { "id": "123e4567-e89b-42d3-a456-426614174006", "type": "job.completed", "workspaceId": "123e4567-e89b-42d3-a456-426614174001", "occurredAt": "2026-10-01T12:00:02Z", "data": { "jobId": "123e4567-e89b-42d3-a456-426614174002", "executionOrigin": "api" } } ], "nextCursor": "example-opaque-cursor" }}Required scope: events:read · Usage points: 2
Credits are charged separately for work that consumes paid services.