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"

improvementBatchId
string<uuid>
required

The improvement batch'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 improvement batch.

Tests one run found at fault, improving together.

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

status
enum<string>
required

running: some test is still improving. paused: the rest settled and some test waits on the budget, a Retell key or credits; resume it from its page in the app once that is fixed. done: every test settled. refused: it did not start (see reason).

Available options:
running,
paused,
done,
refused
reason
string | null
required

Why it is paused or refused, in one line.

spendCeilingUsd
number | null
required

The most of the test budget this batch may spend.

createdAt
string<date-time>
required
Example:

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

updatedAt
string<date-time>
required
Example:

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

totals
object
required

How the batch stands.

tests
object[]
required

One entry per test, in the order they were approved.

batchFixes
object[]
required

Gaps found on several tests at once and fixed once for all of them.