Skip to main content
GET
Get a case

Authorizations

Authorization
string
header
required

Send Authorization: Bearer YOUR_API_KEY. The key resolves to a single organization.

Path Parameters

id
string<uuid>
required

Benchmark id.

caseId
string<uuid>
required

Case id.

Query Parameters

reveal
enum<string>

Return the case's prompt variable values unmasked (audit-logged).

Available options:
variables

Response

Successful response.

A case with its content (transcript, expectations, tools). Reading it is audit-logged.

id
string
required
revision
integer
required
type
enum<string>
required
Available options:
turn,
conversation,
audio
title
string
required
checkGroupId
string | null
required
source
enum<string>
required
Available options:
production,
trace,
manual,
red_team,
api,
mcp,
upload
sourceConversationId
string | null
required
sourceAgent
object | null
required

An agent the benchmark is assigned to.

tags
string[]
required
language
string | null
required
retired
boolean
required
draft
boolean
required
preview
string
required
sourceAgentVersionLabel
string

The agent prompt version the case was written against, e.g. "v7".

referenceUnverified
boolean

audio: the reference transcript came from the call and nobody has checked it yet. The case still runs.

unpublished
boolean
skippedJudgeIds
string[]
judgeParamOverrides
object
addedInVersion
integer | null
retiredInVersion
integer | null
toolExpectation
object

Which tool call(s) a turn case expects.

replyExpectation
object

How the spoken reply of a turn case is checked.

traceSource
object
status
enum<string>
Available options:
ready,
draft,
preparing,
failed
contentPurged
boolean
contentDeleted
boolean

"Delete all call content" blanked this case: content and Judge reasoning are gone, the title is a neutral "Case N · content deleted", scores stay.

createdAt
string

ISO 8601 timestamp.

updatedAt
string

ISO 8601 timestamp.

context
object
persona
object
tools
object[]
toolMocks
object[]
keyTerms
string[]
referenceTranscript
string | null
variables
object
promptAgentVersionId
string | null