> ## 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 Runbook

> Start a Run pinned to a published Runbook revision.

Requires `runs:write`; local execution also requires `runs:local`. Returns
`202 Accepted` with a durable Run.

<ParamField path="runbook_id" type="string" required>
  Published Runbook to execute.
</ParamField>

<ParamField header="X-Idempotency-Key" type="string">
  Stable key for retrying this logical Run creation.
</ParamField>

<ParamField body="inputs" type="object">
  Values declared by the Runbook parameter contract.
</ParamField>

<ParamField body="executionTarget" type="string">
  `cloud` by default, or `local` for a paired Infragrid Desktop.
</ParamField>

<ParamField body="revisionId" type="string">
  Published immutable revision to pin. Omit to atomically select the latest published revision.
</ParamField>

<ParamField body="metadata" type="object">
  Application correlation metadata, at most 16 KB.
</ParamField>

Poll the returned Run with [Get a run](/reference/runs/get) or an SDK `wait()` helper.


## Related topics

- [Programmable Runbooks](/guides/runbooks.md)
- [Get a Runbook](/reference/runbooks/get.md)
- [List Runbooks](/reference/runbooks/list.md)
- [Publish a Runbook](/reference/runbooks/publish.md)
- [Update a Runbook](/reference/runbooks/update.md)