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"

watchId
string<uuid>
required

The watch'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"

Response

The watch.

object
enum<string>
required
Available options:
watch
id
string<uuid>
required
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"

name
string
required
lane
enum<string>
required

The lane a defect lives in: hearing, understanding, flow, speaking or integrations.

Available options:
hearing,
understanding,
flow,
speaking,
integrations
state
enum<string>
required

draft/backtesting while authoring; review once a backtest finished; live once a person turns it on; paused or rejected leave it off.

Available options:
draft,
backtesting,
review,
live,
paused,
rejected
revision
integer
required
origin
string
required
passRate
number | null
required

Share of production calls in scope where the expectation held. Null until there are calls to measure.

calls
integer
required

Production calls behind the pass rate. 0 until there are any.

precision
number | null
required

Of the sample calls a person labelled on the current revision, the share labelled right. Null until any are labelled.

labelled
integer
required
source
object | null
required

For a generated watch (origin generated): the agent version and instruction line it was drafted from. Null otherwise.

firstSample
object | null
required

On a suggested draft: how many past calls the first backtest found in scope and how many it flagged. Null until that backtest finishes. Precision is not known until the draft is kept and its sample calls are labelled.

createdAt
string<date-time>
required
Example:

"2026-10-02T14:03:07.120Z"

updatedAt
string<date-time>
required
Example:

"2026-10-02T14:03:07.120Z"

scope
object
required
expectation
object
required
createdBy
string | null
required
backtest
object | null
required
samples
object[]
required
labels
object
required
goLiveBlock
string | null
required

Why Turn on is refused, or null when the bar is met.