Skip to main content
GET
Get an assistant's build record

Authorizations

Authorization
string
header
required

Project API key (sk_api_…).

Path Parameters

assistantId
string<uuid>
required

The assistantId the build returned.

Response

The build record.

passed, agentName, businessName and sampleTranscripts land only when a build finishes; the rest is written the moment it starts.

organizationId
string<uuid>
projectId
string<uuid>
assistantId
string<uuid>
status
enum<string>

building while the first run is in flight, then ready on success or failed on a crash — the reason lands in error. A refine keeps the previous value until its run ends.

Available options:
building,
ready,
failed
promptVersion
integer

Counts up once per rewrite, so anything above 1 means the grader sent the prompt back.

passed
boolean

Whether the final round ended with nothing flagged. false means the rounds ran out with the grader still objecting: the assistant is callable either way, so read the sample transcripts first.

agentName
string

The name the assistant introduces itself by, chosen during authoring.

businessName
string

The business it says it is calling for, taken from the brief.

brief
object

The brief this build ran from, echoed with the ids it was stored under. A refine that sends a new brief replaces it.

sampleTranscripts
object

The cleanest rehearsal on each path — fewest findings, longest conversation breaking ties. Either path may be missing.

buildId
string<uuid>

The run that last wrote this record — what the status poll's durable fallback matches on.

error
string

Why the last run failed. Only present when status is failed.

updatedAt
string<date-time>

When the record was last written — build start or finish.