List trace events using JWE payload

POST form of GET on this path. It accepts the same parameters as a flat JSON body (TracesQueryBody) instead of a query string, and returns the same response. Use it when the request parameters must be encrypted. See “Sending parameters in a POST body” and “Payload encryption” in the API description.

• Request encryption off: send TracesQueryBody as application/json.
• Request encryption on: send the same object encrypted as an EncryptedRequest, preferably as application/jose+json.
• Response encryption on: every response except 401 is an EncryptedResponse with X-ABL-Encrypted: true.

POST /api/public/analytics/projects/{projectId}/traces

cURL

plain

curl --request POST \ --url https://{host}/api/public/analytics/projects/{projectId}/traces \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' { "fromDate": "2026-08-05T00:00:00.000Z", "toDate": "2026-08-06T00:00:00.000Z", "eventTypes": [ "llm", "tool" ], "dataMode": "summary", "sortOrder": "desc", "limit": 100 } '

200

{
  "protected": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2R0NNIiwia2lkIjoiNjZmN2ExYzJlNGIwYTFkMmMzZTRmNWE2IiwicGtmIjoiZDExYzNlNDcxYjRmNDU4MTA3Y2JiZmFjMzg2NWEwNDZhMjIyZjVlZDcyZDQ2MDUyNDFiMWFjYWI3MjE1MmNlNiJ9",
  "encrypted_key": "XScVR_HSab2Vl58k_P_5xmQaWutTpDzp7oc-1OZXrn6pLVBPx7Z2holovT7U1QWQQeWJVOKIchjQJV2eDtX1wT11kusoQMrgDsgk1kaNgxzQSgiECQUkGJnjCJCzp_wSKiYTpwshpYKYLNjo1lQBCk97ukApMmym_GUBERGQkOhc53bFVEXNd8UFZMrn7-wkChOHbwm5DbMJVboNK9Pqe4InWQRFpg6gaxIqH9XM4bkhydQUxTxwJtvY3fmKhMpT7ZeEbclUCGAHK_xUVLj9yzSadjgDoYT04DetRleOQrjBfC_qr8t3ilWZlpIeqiET5iyEFrxuhqi9zzUIs_6Njw",
  "iv": "Nd51pTVdZKYz8Lt6",
  "ciphertext": "mIzOWlsoKAPVc3lQghwjHA",
  "tag": "BaHsLsjLXYGESMoRsNdr4g"
}

Use this endpoint when you need the same trace data and filtering capabilities as the corresponding GET endpoint, but want to send the query parameters in the request body instead of the URL. The POST endpoint accepts the same parameters and returns the same response as GET.

When request encryption is enabled for the Platform Key, send the TracesQueryBody as an encrypted JWE. When request encryption is disabled, send the same parameters as a plain JSON object. Response encryption is independent of request encryption; when enabled, responses other than 401 are returned as encrypted JWE payloads.

The POST endpoint supports the same filtering parameters as GET. The POST body uses the GET parameter names as JSON property names. List parameters can be sent as JSON arrays or comma-separated strings. traceDimensions is not a parameter in this Traces API; do not use it with this endpoint.

Use POST method when:

• You must encrypt the request parameters.
• You want to avoid exposing potentially sensitive filter values in the URL.
• You need to send the query as a JSON object rather than URL query parameters.

When request encryption is enabled, the plaintext query object is encrypted as a flattened JWE using the configured Platform Key. A plaintext POST body is rejected when request encryption is enabled, while an encrypted body is rejected when request encryption is disabled.

Do not add query parameters to a POST request. All query parameters must be supplied in the request body.

Authorizations

x-api-key · string · header · required

Project-bound API key. Do not send an Authorization header.

Path Parameters

projectId · string · required

Minimum string length: 1

Body

application/jsonapplication/jose+json

Option 1

Option 2

POST form of the GET query parameters: a flat JSON object whose keys are the GET query parameter names. For a Platform Key with request encryption on, send this object encrypted as an EncryptedRequest instead.

fromDate · string<date-time> · required

Same as the fromDate query parameter of the GET operation.

toDate · string<date-time> · required

Same as the toDate query parameter of the GET operation.

limit · integer · default: 100

Same as the limit query parameter of the GET operation.

Required range: 1 <= x <= 10000

cursor · string

Same as the cursor query parameter of the GET operation.

Minimum string length: 1

eventTypes · enum<string>[] string

Same as the eventTypes query parameter of the GET operation. Send a JSON array, or a comma-separated string as in the query string.

Maximum array length: 4

Available options: llm, tool, decision, error

eventNames · enum<string>[] string

Same as the eventNames query parameter of the GET operation. Send a JSON array, or a comma-separated string as in the query string.

Maximum array length: 20

Available options: llm.call.completed, llm.call.failed, tool.call.completed, tool.call.failed, tool.call.skipped, agent.decision

sessionIds · string[] string

Same as the sessionIds query parameter of the GET operation. Send a JSON array, or a comma-separated string as in the query string.

Maximum array length: 10000

Minimum string length: 1

eventId · string

Same as the eventId query parameter of the GET operation.

Minimum string length: 1

traceId · string

Same as the traceId query parameter of the GET operation.

Minimum string length: 1

agentName · string

Same as the agentName query parameter of the GET operation.

Minimum string length: 1

decisionKind · string

Same as the decisionKind query parameter of the GET operation.

Minimum string length: 1

channel · enum<string>

Same as the channel query parameter of the GET operation.

Available options: http_async, slack, line, msteams, whatsapp, messenger, instagram, twilio_sms, zendesk, telegram, genesys, genesys_open_messaging, ai4w, kore_agent_assist, email, voice_vxml, korevg, audiocodes, genesys_audio_connector, voice_pipeline, voice_realtime, voice, voice_twilio, voice_livekit, ag_ui, a2a, sdk_websocket, web_debug, web_chat, api, http

environment · enum<string>

Same as the environment query parameter of the GET operation.

Available options: dev, staging, production, working-copy

hasError · boolean

Same as the hasError query parameter of the GET operation.

dataMode · enum<string> · default: summary

Same as the dataMode query parameter of the GET operation.

Available options: summary, full

sortOrder · enum<string> · default: asc

Same as the sortOrder query parameter of the GET operation.

Available options: asc, desc

Response

200

application/json

Trace event page returned successfully (same body as the GET form).

Option 1

Option 2

traces · object[] · required

The traces on this page. One trace groups the events from a single run.

Show child attributes

pageInfo · object · required

Paging information for this response.

Show child attributes

meta · object · required

Echo of the query that produced this response, plus the values this API supports.

Show child attributes