Traces & Observability
GET
/v1/orgs/{org_id}/traces/analyticsGet Trace Analytics
Get aggregated trace analytics for an organization.
Runtime, CI or Admin tokenscope: readoperation_id: traces.analytics
Authentication
Any bearer token belonging to the org can read this endpoint.
SDK install
pip install znyx-sdknpm install @znyx/sdkPath parameters
| Name | Type | Required | Description |
|---|---|---|---|
| org_id#path | string | required | — |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| days#query | integer | optional | — |
| project_id#query | string | null | optional | Filter by project (app_id) |
| environment#query | string | null | optional | Filter by environment name |
Header parameters
| Name | Type | Required | Description |
|---|---|---|---|
| X-API-Key#header | string | null | optional | — |
| authorization#header | string | null | optional | — |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Response schema
period_daysrequiredinteger
total_tracesrequiredinteger
decisionsrequiredobject
avg_latency_msrequirednumber
Errors & what triggers them
| Code | Trigger | Fix |
|---|---|---|
| 401 | Missing or expired Authorization header. | — |
| 403 | Token does not have org access (wrong org_id, or insufficient role). | — |
| 404 | Resource does not exist in this org. | — |
Request
curl -X GET 'https://api.znyx.ai/v1/orgs/00000000-0000-0000-0000-000000000000/traces/analytics' \ -H 'Authorization: Bearer $ZNYX_TOKEN'
Response
application/json
Successful Response
{
"period_days": 0,
"total_traces": 0,
"decisions": {},
"avg_latency_ms": 0
}Schema: object