Skip to content

Operational API v1

Operational API v1 gives UI clients a stable projection of Rainrail activity without exposing internal store shapes or unsafe provider payloads.

The API groups overview, events, workflow runs, agent tasks, sources, queue, and settings into compact list rows and detailed records. Mutating actions use explicit scope checks and confirmation rules.

Responses must remain dashboard-safe. Raw provider payloads, secrets, tokens, and unbounded log bodies do not belong in public API records.

The full API contract lives in docs/operational-api-v1.md.