For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETQuery customer logs
      • GETDebug R2 SQL diagnostics
      • GETGet aggregated log stats
      • GETTrace a conversation
      • GETTrace an execution
Dashboard
LogoLogo
Runtype APILogs

Trace a conversation

GET
/v1/logs/trace/conversation/:conversationId
GET
/v1/logs/trace/conversation/:conversationId
$curl https://api.runtype.com/v1/logs/trace/conversation/conversationId \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "success": true,
3  "data": {
4    "conversationId": "conv_9f8b7c6d5e4a3b2c1d0e",
5    "executions": [
6      {
7        "executionId": "exec_1234567890abcdef",
8        "timestamp": "2024-06-15T10:45:30Z",
9        "status": "completed",
10        "steps": [
11          {
12            "stepId": "step_1",
13            "action": "input_received",
14            "details": {
15              "inputText": "Hello, how can I help you today?"
16            },
17            "timestamp": "2024-06-15T10:45:31Z"
18          },
19          {
20            "stepId": "step_2",
21            "action": "ai_response_generated",
22            "details": {
23              "responseText": "I can assist you with your account information."
24            },
25            "timestamp": "2024-06-15T10:45:32Z"
26          }
27        ]
28      },
29      {
30        "executionId": "exec_abcdef1234567890",
31        "timestamp": "2024-06-15T10:46:00Z",
32        "status": "completed",
33        "steps": [
34          {
35            "stepId": "step_1",
36            "action": "input_received",
37            "details": {
38              "inputText": "What is my current balance?"
39            },
40            "timestamp": "2024-06-15T10:46:01Z"
41          },
42          {
43            "stepId": "step_2",
44            "action": "ai_response_generated",
45            "details": {
46              "responseText": "Your current balance is $1,250.75."
47            },
48            "timestamp": "2024-06-15T10:46:02Z"
49          }
50        ]
51      }
52    ]
53  }
54}
Returns trace data for all executions within a conversation.
Was this page helpful?
Previous

Trace an execution

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

conversationIdstringRequired
Conversation ID to trace

Response

Conversation trace returned
successboolean
dataany

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error