Published Blueprints

A published Blueprint is a reusable automation whose public surface contains only a display-safe definition and input contract. Integrations can discover active Blueprints and start cloud runs without access to draft authoring data.

Discover a Blueprint

const { data } = await client.blueprints.list({ limit: 25 })
const blueprint = await client.blueprints.get(data[0].id)

blueprints = client.blueprints.list(limit=25)["data"]
blueprint = client.blueprints.get(blueprints[0]["id"])

Each resource includes its ID, command, name, description, active status, input declarations, and latest published revision.

Run an immutable revision

const started = await client.blueprints.runs.create(blueprint.id, {
  inputs: { account_id: "acct_123" },
  revisionId: blueprint.latestRevision.id,
  idempotencyKey: "account-review-acct-123-v1"
})

const finished = await client.blueprints.runs.wait(started.id)
console.log(finished.outputs)

started = client.blueprints.runs.create(
    blueprint["id"],
    {"account_id": "acct_123"},
    revision_id=blueprint["latestRevision"]["id"],
    idempotency_key="account-review-acct-123-v1",
)
finished = client.blueprints.runs.wait(started["id"])
print(finished["outputs"])

Supplying revisionId guarantees that the run uses that immutable published revision. Omit it to atomically pin the latest published revision when the run is created. Every run response includes the chosen revisionId.

Lifecycle

Blueprint runs can report:

queued or running while work is active
waiting_for_approval, paused, or user_controlling when execution is suspended
completed, failed, cancelled, or interrupted when terminal

The SDK wait helpers return on completed, failed, cancelled, or interrupted.

Safe snapshot events

GET /v1/blueprint-runs/{run_id}/events returns at most one display-safe run.snapshot after the requested cursor. It never returns internal node events, browser observations, raw tool data, credentials, or provider details.

let cursor = 0
const page = await client.blueprints.runs.events(started.id, { after: cursor })
cursor = page.nextCursor

Public boundary

The public API does not expose draft creation, graph mutation, validation, testing, or publishing. Those remain authenticated product workflows.

client.blueprints.run() remains a compatibility alias. New integrations should use client.blueprints.runs.create() and the complete runs lifecycle.

Get started

Build automations

Production

Discover a Blueprint

Run an immutable revision

Lifecycle

Safe snapshot events

Public boundary

​Discover a Blueprint

​Run an immutable revision

​Lifecycle

​Safe snapshot events

​Public boundary

Discover a Blueprint

Run an immutable revision

Lifecycle

Safe snapshot events

Public boundary