Run a Blueprint
Published Blueprints
Run a Blueprint
Start a cloud run pinned to a published Blueprint revision.
POST
Run a Blueprint
Requires
blueprints:run. Returns 202 Accepted.
uuid
required
Active published Blueprint to run.
string
Stable mutation key containing 1–255 printable ASCII characters without spaces. Strongly recommended.
object
Values validated against the published input contract. Defaults to an empty object.
uuid
Immutable published revision to execute. Omit to pin the latest revision atomically at creation.
Response
uuid
required
Durable Blueprint run identifier.
uuid
required
Blueprint definition used by the run.
uuid
required
Exact immutable revision pinned by this run.
string
required
Usually
queued or running on acceptance.string
required
Always
cloud for the public API.string
required
Always
api for this resource.Last modified on August 16, 2026