Skip to main content
POST
/
api
/
v1
/
engines
/
{engine_slug}
/
runs
/
{run_id}
/
outcomes
curl --request POST \
  --url https://api.usenexio.com/api/v1/engines/{engine_slug}/runs/{run_id}/outcomes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_id": "7e1d2c3b-1111-4444-8888-aaaaaaaaaaaa",
  "event_type": "accepted",
  "payload": {
    "accepted_at": "2026-06-17T12:00:00Z",
    "accepted_carrier_id": "prog"
  }
}
'
{
  "event_id": "7e1d2c3b-1111-4444-8888-aaaaaaaaaaaa",
  "status": "recorded"
}

Authorizations

Authorization
string
header
required

API key with environment prefix. Use nx_test_... for sandbox and nx_live_... for production. Obtain keys at platform.usenexio.com/settings/api-keys.

Path Parameters

engine_slug
string
required

Engine identifier slug (e.g. default).

run_id
string<uuid>
required

Body

application/json
event_id
string
required

Caller-supplied idempotency key. Re-using it with the same payload is a no-op replay.

event_type
enum<string>
required
Available options:
viewed,
accepted,
overridden,
placement_outcome
payload
object
required

Typed payload whose fields depend on event_type. See the examples.

Response

Idempotent replay. The same event_id and payload was already recorded.

event_id
string
required
status
enum<string>
required
Available options:
recorded