This page documents the canonical HTTP contract for this endpoint.
The path ID must be a valid event definition ObjectId. An empty row_ids list requests a scan subject to limit. The response returns matched row count and the event emitter summary.
Path parameters
definition_idrequiredstring
Event stream definition ObjectId.
| Name | Type | Description |
|---|---|---|
| definition_idrequired | string | Event stream definition ObjectId. |
Body parameters
row_ids· optionalarray<string>
Selected row IDs; default []. Empty means scan rows for matches.
limit· optionalinteger
Maximum rows, 1–5,000; default 500.
| Name | Type | Description |
|---|---|---|
| row_ids | array<string> | Selected row IDs; default []. Empty means scan rows for matches. |
| limit | integer | Maximum rows, 1–5,000; default 500. |
Errors
| Status | Meaning |
|---|---|
| 401 | Authentication is required. |
| 403 | The caller lacks access to the resource or the tables:write scope. |
| 422 | The request does not satisfy the route or typed request contract. |
