Bulk import events

POST

https://cessy.ai/api/rest/tenant-id/app-id/events/import

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

Authentication

AuthorizationBearer

Tenant/app API key or OAuth/JWT bearer token.

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 strings

Errors

400

Bad Request Error

409

Conflict Error

422

Unprocessable Entity Error

1	const url = 'https://cessy.ai/api/rest/tenant-id/app-id/events/import';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"events":[{"type":"UserRegistered","data":{},"scopeKey":"user-12345"}]}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"success": true,
3	"imported": 1,
4	"streams": 1,
5	"warnings": []
6	}

Authentication

Headers

Query parameters

Request

Response

Errors