Traces

Export gen_ai.* + voice.* traces as OTLP/JSON

post

Export the workspace's durable trace spans over a time window as OpenTelemetry Protocol (OTLP/HTTP JSON) spans: gen_ai.* tool-call spans and the per-call voice-isolation voice.* infra spans (allocate / media-attach / reap). Read-only; admin/owner role required; dark behind OTEL_TRACE_EXPORT_ENABLED (404 when off). Paginated PULL API — extract .resourceSpans before forwarding to an OTLP collector. Attributes are an allowlist of tool-call + infra metadata; the raw tool-result error text is NOT exported (PHI-safe by construction).

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

Body

application/json

start_timestring · date-timeRequired

Inclusive lower bound on span effective_at (ISO-8601).

end_timestring · date-timeRequired

Exclusive upper bound on span effective_at (ISO-8601).

limitinteger · max: 1000Optional

Max spans per page (1-1000).

Default: 500

continuation_tokenanyOptional

Opaque page cursor — round-trip the value from the previous response.

Responses

200

Successful Response

application/json

Paginated PULL response — NOT a bare OTLP ExportTraceServiceRequest.

resourceSpans is OTLP/JSON-conformant; to forward to an OTLP collector, extract .resourceSpans and re-wrap as {"resourceSpans": [...]} (a strict protojson push receiver rejects the has_more/continuation_token siblings). Round-trip continuation_token to page.

has_morebooleanRequired

continuation_tokenanyOptional

422

Validation Error

application/json

post/v1/{workspace_id}/traces:export

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/traces:export HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "start_time": "2026-07-10T21:48:22.855Z",
  "end_time": "2026-07-10T21:48:22.855Z",
  "limit": 500,
  "continuation_token": null
}

{
  "resourceSpans": [
    {
      "resource": {
        "attributes": [
          {
            "key": "text",
            "value": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ]
      },
      "scopeSpans": [
        {
          "scope": {
            "name": "text",
            "version": "text"
          },
          "spans": [
            {
              "traceId": "text",
              "spanId": "text",
              "name": "text",
              "kind": 1,
              "startTimeUnixNano": "text",
              "endTimeUnixNano": "text",
              "attributes": [
                {
                  "key": "text",
                  "value": {
                    "ANY_ADDITIONAL_PROPERTY": "anything"
                  }
                }
              ],
              "status": {
                "code": 1
              }
            }
          ]
        }
      ]
    }
  ],
  "has_more": true,
  "continuation_token": null
}