Trace a conversation | Runtype Documentation

{
  "success": true,
  "data": {
    "conversationId": "conv_9f8b7c6d5e4a3b2c1d0e",
    "executions": [
      {
        "executionId": "exec_1234567890abcdef",
        "timestamp": "2024-06-15T10:45:30Z",
        "status": "completed",
        "steps": [
          {
            "stepId": "step_1",
            "action": "input_received",
            "details": {
              "inputText": "Hello, how can I help you today?"
            },
            "timestamp": "2024-06-15T10:45:31Z"
          },
          {
            "stepId": "step_2",
            "action": "ai_response_generated",
            "details": {
              "responseText": "I can assist you with your account information."
            },
            "timestamp": "2024-06-15T10:45:32Z"
          }
        ]
      },
      {
        "executionId": "exec_abcdef1234567890",
        "timestamp": "2024-06-15T10:46:00Z",
        "status": "completed",
        "steps": [
          {
            "stepId": "step_1",
            "action": "input_received",
            "details": {
              "inputText": "What is my current balance?"
            },
            "timestamp": "2024-06-15T10:46:01Z"
          },
          {
            "stepId": "step_2",
            "action": "ai_response_generated",
            "details": {
              "responseText": "Your current balance is $1,250.75."
            },
            "timestamp": "2024-06-15T10:46:02Z"
          }
        ]
      }
    ]
  }
}

Returns trace data for all executions within a conversation.

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

$	curl https://api.runtype.com/v1/logs/trace/conversation/conversationId \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"