Skip to main content
GET
Poll a build's progress

Authorizations

Authorization
string
header
required

Project API key (sk_api_…).

Path Parameters

buildId
string<uuid>
required

The buildId the build or refine returned.

Response

The run's latest frame.

buildId
string<uuid>
assistantId
string<uuid>

Absent while phase is authoring through refining. Keep the id the start-build response gave you.

status
enum<string>

started lasts a moment, so the first poll usually already reads running. done and failed are terminal.

Available options:
started,
running,
done,
failed
phase
enum<string>

Step the pipeline is on: the prompt is written (authoring), test personas are generated, each rehearses a text-only call (testing), the transcripts are graded (judging), and anything the grader flags drives a rewrite (refining) before the next round.

Available options:
authoring,
generating_personas,
testing,
judging,
refining,
persisting,
done,
failed
round
integer

Which hardening round is running, 1 to 3; 0 on frames outside the loop.

persona
string

The test persona whose rehearsal just finished. Only while testing.

transcriptsDone
integer

Rehearsals finished this round. Only while testing.

transcriptsTotal
integer

Rehearsals in this round. Present while testing and on the judging frame.

error
string

Why the run stopped, when status is failed. A second run against an assistant that is already building fails here rather than at the request: A build is already in progress for this assistant.

result
object

The finished build. Present only once status is done.