v4

latestOpenAPI 3.0.32026-08-0161180264.4 KB

integrations

queryEvents

Query events for a specific integration

post/v1/integrations/{integrationId}/events

Path parameters

integrationIdstring uuid required

The integration ID

Request body

event_idstring

Filter by event ID

event_type'CREATE' | 'UPDATE' | 'DELETE'

Filter by event type

correlation_idstring

Filter by correlation ID

object_typestring

Filter by object type

event_namestring

Filter by event name (alias for object_type)

use_case_idstring

Filter by use case ID

limitinteger

Maximum number of results to return

Example request

{
  "limit": 25,
  "cursor": {
    "event_time": "2025-10-31T12:34:56Z",
    "event_id": "evt_1234567890abcdef"
  }
}

Response

Events queried successfully

has_moreboolean

Indicates if more results are available

Example response

{
  "data": [
    {
      "deduplication_id": "evt-2025-05-01-12345-create-bp",
      "correlation_id": "bp-8f3a2c-7d4e-4b1a-9c2f-1e6d5a4b3c21"
    }
  ],
  "next_cursor": {
    "event_time": "2025-10-31T12:34:56Z",
    "event_id": "evt_1234567890abcdef"
  },
  "has_more": true
}