Skip to navigation
Runtime API TemplateEvents

Bulk import events

Imports historical events directly into runtime event streams. This bypasses command business rules and is intended for migration, seed, and replay workflows.

Authentication

AuthorizationBearer

Runtime bearer accepted by the normal app-scoped pipeline: an API key or OAuth/JWT with the ‘runtime’ scope, or an app-scoped agent service token. Individual operations may require a narrower principal type.

Headers

X-CES-Workspace-IDstringOptionalformat: "^ws_[A-Za-z0-9_-]+$"
Optional Workspace runtime selector header. If supplied with workspaceId, both values must match.

Query parameters

workspaceIdstringOptionalformat: "^ws_[A-Za-z0-9_-]+$"

Optional Workspace runtime selector for preview or validation calls. If supplied with X-CES-Workspace-ID, both values must match.

Request

This endpoint expects an object.
eventslist of objectsRequired
publishToEventBusbooleanOptionalDefaults to true

Response

Events imported
successboolean
importedinteger
streamsinteger
warningslist of stringsOptional

Errors

400
Bad Request Error
409
Conflict Error
422
Unprocessable Entity Error