Skip to main content
POST
/
api
/
v1
/
engine
/
events
Error
A valid request URL is required to generate request examples
{
  "event_id": "01935-eeee-…",
  "subscriptions_matched": 2,
  "execution_ids": [
    "01935-aaaa-…",
    "01935-bbbb-…"
  ]
}

Authorizations

Authorization
string
header
required

Deploy-wide server-to-server bearer token (ENGINE_API_TOKEN), validated by the engine_api firewall. Authenticates the Engine API, Knowledge base, and Conversions surfaces. The tenant_id rides in the request body and is trusted in V1 — keep this token strictly server-side.

Body

application/json
tenant_id
string<uuid>
required
event_name
string
required

snake/dotted event name to emit.

data
object

Event payload merged into the execution context of matched subscriptions.

idempotency_key
string | null

Body-level idempotency key; a repeat emits the event only once.

Response

Event accepted

event_id
string
required
subscriptions_matched
integer
required
execution_ids
string[]
required

One execution id per matched, filter-passing subscription.