Read the trace of a finalized Call

GET /v1/calls/{call_id}/trace

The segments of the Call's trace with their marks, stages, Providers, quality flags and per-Turn cost, and the content classes include names (ADR 0058). From 1.57.0 (workspace ADR 0048 decision 6) include=tool_payloads adds the Tool payloads with tool_payloads:read; turns limits the segments to a range of Turns; and the answer carries the recording alignment, the basis of the per-Turn cost, the post-call analyses and, for a Member, the reveal grant that let it include a class. With an API key each class needs its scope; a Member reads a class its role's visibility cell allows, or one an active reveal grant covers for the Call, and is refused otherwise with 403 forbidden naming the missing permission in details. Naming any class makes the read an audited content read, whose Audit event carries the reveal_grant_id when a grant was used. The segments' cost needs usage:read (1.29.0).

Request

Set VOCAL_API to the base URL of your API and VOCAL_API_KEY to an API key with the calls:read scope (Authentication and keys). Replace each placeholder, such as agt_... or <name>, with your own value.

curl "$VOCAL_API/v1/calls/call_.../trace" \
  -H "Authorization: Bearer $VOCAL_API_KEY"

const response = await fetch(`${process.env.VOCAL_API}/v1/calls/call_.../trace`, {
  headers: {
    Authorization: `Bearer ${process.env.VOCAL_API_KEY}`,
  },
});
console.log(response.status, await response.text());

import os

import requests

response = requests.get(
    f"{os.environ['VOCAL_API']}/v1/calls/call_.../trace",
    headers={
        "Authorization": f"Bearer {os.environ['VOCAL_API_KEY']}",
    },
)
print(response.status_code, response.text)

Parameters

Responses

Fields of the 200 answer

The shape is CallTrace.