Skip to main content
GET
/
v4
/
test-cases
/
{id}
Get a single test case
curl --request GET \
  --url https://gentrace.ai/api/v4/test-cases/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "createdAt": "2025-04-01T00:00:00.000Z",
  "updatedAt": "2025-04-01T00:00:00.000Z",
  "inputs": {
    "query": "What is the capital of France?"
  },
  "expectedOutputs": {
    "answer": "Paris"
  },
  "datasetId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Capital of France query",
  "pipelineId": "abcdef12-3456-7890-abcd-ef1234567890",
  "archivedAt": "2025-04-01T00:00:00.000Z",
  "deletedAt": "2025-04-01T00:00:00.000Z"
}

Documentation Index

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

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

Authorizations

​
Authorization
string
header
required

Enter Gentrace API key (Format: Authorization: Bearer )

Path Parameters

​
id
string<uuid>
required

Test Case UUID

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

Successful response

​
id
string<uuid>
required

Test Case UUID

Example:

"a1b2c3d4-e5f6-7890-1234-567890abcdef"

​
createdAt
string
required

Creation timestamp (ISO 8601)

Example:

"2025-04-01T00:00:00.000Z"

​
updatedAt
string
required

Last update timestamp (ISO 8601)

Example:

"2025-04-01T00:00:00.000Z"

​
inputs
object
required

Input data for the test case

Example:
{ "query": "What is the capital of France?" }
​
expectedOutputs
object
required

Expected output data for the test case

Example:
{ "answer": "Paris" }
​
datasetId
string
required

Associated Dataset UUID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
name
string
required

Test Case name

Example:

"Capital of France query"

​
pipelineId
string<uuid>
required

Associated Pipeline UUID

Example:

"abcdef12-3456-7890-abcd-ef1234567890"

​
archivedAt
string | null
required

Archive timestamp (ISO 8601)

Example:

"2025-04-01T00:00:00.000Z"

​
deletedAt
string | null
required

Deletion timestamp (ISO 8601)

Example:

"2025-04-01T00:00:00.000Z"