Get Build Snapshot

Return the latest ProvisioningEvent for a build. This is the stateless alternative to the SSE stream — ideal for “email-me-a-link” backends that don’t hold a connection, or for a quick status check. The payload is the same shape as the SSE data and the webhook body, so there is no separate client code path.

Authentication

Header	Value	Required
`Authorization`	`Bearer brs_live_YOUR_KEY`	Yes

Same agents:write-scoped key as from-url. NEVER call this from a browser.

Path Parameters

string

required

The bld_… id returned by from-url (also available as the pollUrl).

Response — `200 OK`

Returns a single ProvisioningEvent.

string

Build identifier.

string

One of queued, detecting, scraping, analyzing, provisioning, indexing, ready, failed.

number

0–100, monotonic, phase-weighted.

string

Current phase (same enum as status).

string

Human-readable display copy.

string

Optional sub-status (e.g. “Indexed 6 of 8 videos”).

string

youtube or instagram, once detected.

string

Detected channel title.

string

Present only when status is ready.

string[]

Present only when ready — seed the chat UI.

string

Soft issue (e.g. “Limited public content found”).

object

Present only when status is failed.

Show error object

string

A ProvisioningErrorCode.

string

Human-readable message.

boolean

Whether retrying may succeed.

string

ISO8601 timestamp; also the SSE id: for resume.

Examples

curl https://app.brainstormer.io/v1/agents/builds/bld_8c9d0e1f2a3b \
  -H "Authorization: Bearer brs_live_YOUR_KEY"

async function pollBuild(buildId: string) {
  const res = await fetch(
    `https://app.brainstormer.io/v1/agents/builds/${buildId}`,
    { headers: { Authorization: "Bearer brs_live_YOUR_KEY" } },
  );
  if (!res.ok) throw new Error(`poll failed: ${res.status}`);
  return res.json(); // a ProvisioningEvent
}

// Poll until terminal:
let event = await pollBuild("bld_8c9d0e1f2a3b");
while (event.status !== "ready" && event.status !== "failed") {
  await new Promise((r) => setTimeout(r, 2000));
  event = await pollBuild("bld_8c9d0e1f2a3b");
}
if (event.status === "ready") console.log("Chat at slug:", event.agentSlug);

Response (200) — in progress:

{
  "buildId": "bld_8c9d0e1f2a3b",
  "status": "analyzing",
  "progress": 55,
  "step": "analyzing",
  "stepLabel": "Learning the creator's voice",
  "detail": "Generating system prompt",
  "platform": "youtube",
  "channelTitle": "The Channel",
  "emittedAt": "2026-06-14T01:36:52.957Z"
}

Response (200) — ready:

{
  "buildId": "bld_8c9d0e1f2a3b",
  "status": "ready",
  "progress": 100,
  "step": "ready",
  "stepLabel": "Your agent is ready",
  "platform": "youtube",
  "channelTitle": "The Channel",
  "agentSlug": "the-channel-agent",
  "starterQuestions": [
    "What videos have you made about productivity?",
    "Summarize your latest upload",
    "What gear do you recommend?"
  ],
  "emittedAt": "2026-06-14T01:38:10.221Z"
}

HTTP Status Codes

Status	Meaning
`200 OK`	Snapshot returned.
`401`	Missing or invalid `Authorization` header.
`403 insufficient_scope`	Key lacks the `agents:write` scope.

For live, push-based progress (a wait-on-page UX), prefer the SSE stream. Use polling for stateless or email-me-a-link backends.

Getting Started

Agent Provisioning

Bot Service

Auth Service

Knowledge Service

Get Build Snapshot

Get Build Snapshot

Authentication

Path Parameters

Response — `200 OK`

Examples

HTTP Status Codes

​Get Build Snapshot

​Authentication

​Path Parameters

​Response — 200 OK

​Examples

​HTTP Status Codes

Get Build Snapshot

Authentication

Path Parameters

Response — `200 OK`

Examples

HTTP Status Codes