Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

An API key (sig_...), or a session token from the web app.

Path Parameters

agentId
string<uuid>
required

The agent's id.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

Query Parameters

limit
integer
default:25

Items per page, 1 to 100.

Required range: 1 <= x <= 100
Example:

25

cursor
string

nextCursor from the previous page.

Minimum string length: 1
testSetId
string<uuid>

Only tests in this set.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

lane
enum<string>

Only tests in this lane.

Available options:
hearing,
understanding,
flow,
speaking,
integrations
intent
string

Only tests for this intent slug.

Minimum string length: 1
source
enum<string>

Only tests from this source.

Available options:
production,
custom,
probe
lastResult
enum<string>

Only tests whose latest attempt with their own caller has this result; none: never run.

Available options:
passed,
failed,
flaky,
error,
drift,
none
archived
enum<string>
default:exclude

Archived tests are left out (exclude) unless asked for: include them, or only them.

Available options:
exclude,
include,
only
state
enum<string>

Only drafts, or only accepted tests.

Available options:
draft,
accepted

Response

A page of tests.

object
enum<string>
required
Available options:
list
data
object[]
required
hasMore
boolean
required
nextCursor
string | null
required

Pass as cursor for the next page; null on the last page.