Skip to main content
GET
/
v1
/
test-cases
/
{testCaseId}
Get Test Case
curl --request GET \
  --url https://api.sigmamind.ai/v1/test-cases/{testCaseId} \
  --header 'X-API-Key: <api-key>'
{
  "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."
}

Documentation Index

Fetch the complete documentation index at: https://docs.sigmamind.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. To get your key, go to Dashboard → API Keys and create or copy your Production API key.

Path Parameters

​
testCaseId
string
required

Unique identifier of the test case to retrieve. Obtained from the testCaseId field in the Create Test Case or List Test Cases response.

Query Parameters

​
agentId
string
required

Unique identifier of the agent to which the test case belongs.

Response

OK

​
testCaseId
string

The unique identifier of the test case.

Example:

"tc_d17T6uReChpyfFeP"

​
label
string

A human-readable name or label for the test case, used to identify it in reports and dashboards.

Example:

"Angry Customer - Cancellation Flow"

​
agent
object

Agent assigned to handle all calls in this campaign. Contains the agent's ID, name, and current status. All contacts in the campaign's contact list will be called using this agent.

​
workspaceId
string

The unique identifier of the workspace under which this test case was created.

Example:

"org_V6eZ2zg8ziDx5pft"

​
llmModel
string

The LLM model used to generate Agent responses during the simulation.

Example:

"gpt-4o-mini"

​
mockData
object[]

The list of mock variables and their simulated values that were used to substitute for real external data sources during the simulation.

Example:
[
  {
    "variableName": "customer_name",
    "value": "John Doe"
  },
  {
    "variableName": "account_status",
    "value": "active"
  }
]
​
userPrompt
string

The prompt that defined the persona and intent of the simulated user, driving the user-side messages throughout the conversation.

Example:

"You are an angry customer who wants to cancel your subscription."

​
attempt
integer<int64>

The number of times this test case was configured to run as independent simulation attempts.

Example:

5

​
successCriteria
string

The plain-language description of what a successful agent response looks like, used to evaluate the agent's performance after each simulation run.

Example:

"The agent should acknowledge the cancellation request, present retention alternatives, and confirm the cancellation if the customer insists."