Switchboard API
Switchboard API
Switchboard's primary API is GraphQL at AppSync, reached through this gateway (every console read and mutation — connections, repositories, environments, instances, builds, channels — lives there; see the design's D1). This REST surface is deliberately narrow: the operations that need callers with no GraphQL client. Two use cases: the release process — what QA tooling, the operation-phase plugin, and regression agent runners drive — and manifest validation for CI. Every operation is a stub returning an example payload; construction replaces the stub handler with the real resolver path and adds the require-auth inbound policy per routes-and-policies.md.
Tags
Manifest
CI-facing: validate a switchboard.yaml without a GraphQL client — a repo lints its manifest on every push.
Releases
The release process: assemble from channel heads, hold an environment, test, request approval, ship. The QA implementation team's surface — and the operation-phase plugin's.
Regression suites
Generated from what ships; steps run as guided human tests or agent runs, and every result carries evidence — a screenshot of the run.
GraphQL