/v1 and use JSON.
The Runbook endpoints and the
infragrid TypeScript package are a preview
contract. They are not available in the production API or npm registry until
the corresponding API rollout is complete.Authentication
Resources
Runs
Start ad-hoc or Runbook executions, recover status, list history, and cancel work.
Runbooks
Create, update, publish, and execute reusable programmable definitions.
API keys
Manage scoped workspace credentials through an authenticated dashboard session.
Pagination
- Runs use
limitandoffset. - Runbooks use a bounded
limit. - List endpoints return at most 100 items.
Idempotency
POST /v1/runs, POST /v1/runbooks, and
POST /v1/runbooks/{runbook_id}/runs accept X-Idempotency-Key. Reusing the
same key with a different request body returns 409.
Run statuses
Runs reportqueued, running, waiting_for_approval, completed, failed,
or cancelled.