Inject a Leg Into a Call Trace

POST

/sipflow/event

Last modified:2026-09-20 18:17:45

OperationId:InjectCallTraceEvent

Insert one event row into the day's SIP event table so another application can place its own leg into a call's flow. The injected row renders alongside the SIP packets in every trace format (call_trace, call_trace_details, call_trace_html, call_trace_text, csv, cradle_to_grave).

Only orig_callid, event_type and event_text are required. event_index, event_ts, event_time and hostname are generated by the API; the last three can be overridden.

Super User scope only. Super User Read Only is refused — this is a write.

Notes:

The row is written to the local server's diagnostic database. If the call's CDR names a different server, inject on that server.

The daily event table is created by the telephony daemon, not by the API. If it does not yet exist for the effective event_time, the request is refused with 409.

A trace that has already been fetched is cached; inject before the trace is first viewed, or wait out the cache TTL.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

The created row, including the server-generated fields.

Bodyapplication/json

🟠400Bad Request

🟠403Forbidden

🟠409Conflict

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/sipflow/event' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "orig_callid": "my-random-unique-callid",
    "event_type": "app",
    "event_text": "IVR: caller selected option 2",
    "servedCallId": "string",
    "hostname": "string",
    "event_time": "2026-09-20 18:04:11",
    "event_ts": "1789329851000"
}'

Response Example

{
    "event-index": 918273,
    "orig-callid": "my-random-unique-callid",
    "served-callid": null,
    "event-type": "app",
    "event-time": "2026-09-20 18:04:11",
    "event-ts": "1789329851000",
    "hostname": "eng0-san.netsapiens.com",
    "table": "event_20260920"
}

Modified at 2026-09-20 18:17:45

Get CSV of call trace For Call

Read Transcription for Specific Call