Sign in

v1

latestOpenAPI 3.0.12026-07-226992320.0 KB
Test Runs

Get Test Run

Retrieves the full details of a single test run by jobId, scoped to the specified batch and agent. Returns the test case name, execution status, expected and actual outcomes, and transcript details.

get/v1/test-runs/{jobId}

Path parameters

jobIdstring required

The unique identifier of the simulation run to retrieve.

Query parameters

batchIdstring required

The unique identifier of the batch run to which this simulation run belongs.

agentIdstring required

Unique identifier of the agent to which the batch run belongs.

Response

OK

batchIdstring

The unique identifier of the batch run this simulation attempt belongs to.

workspaceIdstring

The unique identifier of the workspace under which this simulation attempt was created.

jobIdstring

The unique identifier of this individual simulation attempt within the batch run.

chatIdstring

The unique identifier of the chat session generated during this simulation run.

createdDatestring date-time

The UTC timestamp indicating when this simulation run was initiated.

completedDatestring date-time

The UTC timestamp indicating when this simulation run was completed.

isSuccessfulboolean

Indicates whether the Agent met the success criteria during this simulation run.

remarksstring

A plain-language explanation of why the simulation run was evaluated as successful or failed, based on the success criteria.

Example response

{
  "batchId": "batch_s0OJu2JWR8R45Fai",
  "workspaceId": "org_V6eZ2zg8ziDx5pft",
  "agent": {
    "name": "New AI Agent",
    "agentId": "agent_D5D0p7TUs66TTAEAx",
    "status": "Live"
  },
  "testCase": {
    "testCaseId": "tc_d17T6uReChpyfFeP",
    "label": "Angry Customer - Cancellation Flow",
    "agent": {
      "name": "New AI Agent",
      "agentId": "agent_D5D0p7TUs66TTAEAx",
      "status": "Live"
    },
    "workspaceId": "org_V6eZ2zg8ziDx5pft",
    "llmModel": "gpt-4o-mini",
    "mockData": [
      {
        "variableName": "customer_name",
        "value": "John Doe"
      },
      {
        "variableName": "account_status",
        "value": "active"
      }
    ],
    "userPrompt": "You are an angry customer who wants to cancel your subscription.",
    "attempt": 5,
    "successCriteria": "The agent should acknowledge the cancellation request, present retention alternatives, and confirm the cancellation if the customer insists."
  },
  "jobId": "job_ksUu5yRHGTLLrLeM",
  "chatId": "chat_IpELinkFvINQ1212",
  "createdDate": "2026-03-26T10:52:45.565Z",
  "completedDate": "2026-03-26T10:54:45.565Z",
  "isSuccessful": true,
  "remarks": "The Agent successfully maintained focus on the primary task of addressing the customer's order enquiry.",
  "conversation": [
    {
      "role": "user",
      "content": "I want to cancel my subscription immediately."
    }
  ]
}