Skip to content
Test Suites

GEThttps://core-api.heysadie.ai/test-runs

limit offset suiteId assistantId view success data testRuns id tenantId status mode iterations suiteSnapshot name cases sortOrder personaInstructions expectedOutcome maxTurns seedMessages toolMocks assertions createdAt updatedAt caseResults usage costUsd costBreakdown error livekitRoom startedAt finishedAt total metadata timestamp version path code message details field

List test runs

Try it in the API Explorer

Example request

Terminal
curl "https://core-api.heysadie.ai/test-runs?limit=10&offset=0" \
  -H "Authorization: ApiKey YOUR_API_KEY"

Authentication

Authenticate with an API key in the Authorization header using the ApiKey scheme. See Authentication for how keys work and where to get them.

Authorizationstringrequired

API key in the ApiKey scheme: ApiKey YOUR_API_KEY. Tenant keys authorize their own tenant; organization keys can act on any tenant in the organization.

X-Tenant-Idstring (uuid)optional

Required when authenticating with an organization key: it selects the tenant the request acts on. Omit with tenant keys.

Request

Query parameters

limitstringoptional

Max number of records to return

offsetstringoptional

Number of records to skip

suiteIdstring (uuid)optional

Filter runs by suite ID

assistantIdstring (uuid)optional

Filter runs by assistant ID

viewenumoptional

summary omits suite cases, transcripts, and usage so a list page stays small. Default full.

Allowed values:"summary""full"

Responses

200
successbooleanrequired

true on every 2xx

dataobjectoptional

The result

Show 2 child properties
testRunsobject[]required
Show 17 item properties
idstringrequired
tenantIdstringrequired
assistantIdstring | nullrequired
suiteIdstring | nullrequired
statusenumrequired
Allowed values:"queued""running""passed""failed""error"
modeenumrequired
Allowed values:"text""voice"
iterationsnumberrequired
suiteSnapshotobjectrequired
Show 4 child properties
idstringrequired
namestringrequired
assistantIdstringrequired
casesobject[]required
Show 12 item properties
idstringrequired
suiteIdstringrequired
namestringrequired
sortOrdernumberrequired
personaInstructionsstringrequired
expectedOutcomestringrequired
maxTurnsnumberrequired
seedMessagesobject[] | nullrequired
toolMocksmap<string, any>required
assertionsobject[]required
createdAtstring (date-time) | string (date) | number | string | nullrequired
updatedAtstring (date-time) | string (date) | number | string | nullrequired
caseResultsany | nullrequired
usagemap<string, any> | nullrequired
costUsdstring | number | nullrequired
costBreakdownany | nullrequired
errorstring | nullrequired
livekitRoomstring | nullrequired
createdAtstring (date-time) | string (date) | number | nullrequired
startedAtstring (date-time) | string (date) | number | nullrequired
finishedAtstring (date-time) | string (date) | number | nullrequired
totalnumberrequired
metadataobjectoptional

Request metadata

Show 3 child properties
timestampstringrequired

When the server answered, ISO 8601 UTC

versionstringrequired

API version

pathstringoptional

The URL that was requested

400The request is invalid. `details` lists each field that failed
successbooleanrequired

false on every error

errorobjectoptional

What went wrong: a stable `code` to branch on and a human-readable `message`

Show 3 child properties
codeenumrequired

A parameter or body field broke a rule

Allowed values:"VALIDATION_ERROR"
messagestringrequired

Human-readable explanation. Do not parse it; branch on `code`

detailsobject[]optional

One entry per field that failed

Show 2 item properties
fieldstringrequired

The offending field

messagestringrequired

The rule it broke

metadataobjectoptional

Request metadata

Show 3 child properties
timestampstringrequired

When the server answered, ISO 8601 UTC

versionstringrequired

API version

pathstringoptional

The URL that was requested

401Missing or invalid credentials
successbooleanrequired

false on every error

errorobjectoptional

What went wrong: a stable `code` to branch on and a human-readable `message`

Show 2 child properties
codeenumrequired

No valid credentials

Allowed values:"UNAUTHORIZED"
messagestringrequired

Human-readable explanation. Do not parse it; branch on `code`

metadataobjectoptional

Request metadata

Show 3 child properties
timestampstringrequired

When the server answered, ISO 8601 UTC

versionstringrequired

API version

pathstringoptional

The URL that was requested

403The credentials are valid but may not use this route
successbooleanrequired

false on every error

errorobjectoptional

What went wrong: a stable `code` to branch on and a human-readable `message`

Show 2 child properties
codeenumrequired

The credentials may not use this route

Allowed values:"FORBIDDEN"
messagestringrequired

Human-readable explanation. Do not parse it; branch on `code`

metadataobjectoptional

Request metadata

Show 3 child properties
timestampstringrequired

When the server answered, ISO 8601 UTC

versionstringrequired

API version

pathstringoptional

The URL that was requested

404Not found, or outside the caller's scope
successbooleanrequired

false on every error

errorobjectoptional

What went wrong: a stable `code` to branch on and a human-readable `message`

Show 2 child properties
codeenumrequired

An id names nothing the caller can see

Allowed values:"RESOURCE_NOT_FOUND"
messagestringrequired

Human-readable explanation. Do not parse it; branch on `code`

metadataobjectoptional

Request metadata

Show 3 child properties
timestampstringrequired

When the server answered, ISO 8601 UTC

versionstringrequired

API version

pathstringoptional

The URL that was requested

500An unexpected server error
successbooleanrequired

false on every error

errorobjectoptional

What went wrong: a stable `code` to branch on and a human-readable `message`

Show 2 child properties
codeenumrequired

An unexpected server failure

Allowed values:"INTERNAL_SERVER_ERROR"
messagestringrequired

Human-readable explanation. Do not parse it; branch on `code`

metadataobjectoptional

Request metadata

Show 3 child properties
timestampstringrequired

When the server answered, ISO 8601 UTC

versionstringrequired

API version

pathstringoptional

The URL that was requested