v4

latestOpenAPI 3.1.02026-08-03427198448.4 KB

Publish Spine Event

Publish ONE event onto the unified-events spine.

Server-stamped: org_id from the auth context, actor=('user', user_id) ALWAYS, source='user'. Client-supplied actor fields are ignored by construction (this endpoint never reads one). Rejects the app.page.* clickstream namespace, caps payload size (~8KB) and links length (≤5), then calls emit_event.

post/api/events/publish

Query parameters

user_idstring

org_idstring

Request body

event_typestring required

Namespaced canonical (e.g. 'contact.created') or legacy name

messagestring nullable

Human-readable event_message

payloadobject nullable

Stored in events.metadata (≤8KB)

occurred_atstring date-time nullable

Occurred time; defaults to now

Response

Successful Response

{"stackTrail":"paths:/api/events/publish:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}