Skip to main content

Operations & events

Bulk operations over a tenant's data, plus the live change stream. Several of these are long-running and return 202 Accepted immediately.

Tenant-wide administrative operations (rebuild, ACL rebuild, recalculate, sync, delete tenant data) live under the Admin API instead — being admin-only follows from that prefix rather than from registration on this branch.

Import from Excel​

POST /data/{tenant}/import

Imports objects from an Excel file described by an ImportTask body. Returns 201 Created with a Location on success.

TODO

Interview needed. Document the ImportTask body (source file reference, target type, column mapping), and how import maps rows to objects and relations.

Load default data​

POST /data/{tenant}/loadDefaultData

Loads the default data fixtures declared in the model.

TODO

Interview needed. Document when this is used, idempotency (re-running), and interaction with existing data.

Event stream​

GET /data/{tenant}/eventStream

A Server-Sent Events stream (text/event-stream) of data-change events for the tenant.

TODO

Interview needed. Document the event shape, which changes emit events, filtering/scoping, reconnection semantics, and intended consumers (e.g. live-updating UIs).