> ## Documentation Index
> Fetch the complete documentation index at: https://docs.infragrid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Run a Blueprint

> Start a cloud run pinned to a published Blueprint revision.

Requires `blueprints:run`. Returns `202 Accepted`.

<ParamField path="blueprint_id" type="uuid" required>
  Active published Blueprint to run.
</ParamField>

<ParamField header="X-Idempotency-Key" type="string">
  Stable mutation key containing 1–255 printable ASCII characters without spaces. Strongly recommended.
</ParamField>

<ParamField body="inputs" type="object">
  Values validated against the published input contract. Defaults to an empty object.
</ParamField>

<ParamField body="revisionId" type="uuid">
  Immutable published revision to execute. Omit to pin the latest revision atomically at creation.
</ParamField>

## Response

<ResponseField name="id" type="uuid" required>
  Durable Blueprint run identifier.
</ResponseField>

<ResponseField name="blueprintId" type="uuid" required>
  Blueprint definition used by the run.
</ResponseField>

<ResponseField name="revisionId" type="uuid" required>
  Exact immutable revision pinned by this run.
</ResponseField>

<ResponseField name="status" type="string" required>
  Usually `queued` or `running` on acceptance.
</ResponseField>

<ResponseField name="executionTarget" type="string" required>
  Always `cloud` for the public API.
</ResponseField>

<ResponseField name="triggerKind" type="string" required>
  Always `api` for this resource.
</ResponseField>

<Tip>
  Persist the returned run ID and revision ID with your application job.
</Tip>


## Related topics

- [TypeScript SDK](/sdks/typescript.md)
- [MCP server](/tools/mcp.md)
- [Create an API key](/reference/api-keys/create.md)
- [Cancel a Blueprint run](/reference/blueprint-runs/cancel.md)
- [List Blueprint runs](/reference/blueprint-runs/list.md)