Skip to main content
POST
Back to the Analytics APIs overview 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. To return the response headers of HTTP tool calls, send includeResponseHeaders as a JSON boolean. It works as it does in the GET endpoint and needs "dataMode": "full". The default is false. A request with includeResponseHeaders set to true and no full data mode returns 400 INVALID_PARAM_COMBINATION. A non-boolean value returns 400 INVALID_INCLUDE_RESPONSE_HEADERS. For the response fields, see Response headers. The response is the same as for GET. Workflow tool events include workflowRun, and meta.warnings appears when part of the page can’t be served in full. For details, see Workflow runs and Warnings. 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. Set Content-Type to application/json or application/jose+json. The body must be a JSON object. Do not add query parameters to a POST request.

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

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

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

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

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
includeResponseHeaders
boolean
default:false

Same as the includeResponseHeaders query parameter of the GET operation.

sortOrder
enum<string>
default:asc

Same as the sortOrder query parameter of the GET operation.

Available options:
asc,
desc

Response

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

traces
object[]
required

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

pageInfo
object
required

Paging information for this response.

meta
object
required

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