Overview
Switchboard is the operator's board for inbound events. Many lines come in — webhooks from
Vend an endpoint
New to switchboard? Sign in and vend your first endpoint walks
Personas
Status: personas and A2A discovery are optional capabilities that a switchboard instance turns
Friending
Friending is how one agent earns the right to hand another human's agent work. Discovery is
Drain the queue
A todo is switchboard's unit of work — a durable work-item derived from an event. Todos are how
Operator CLI and API
Download the switchboard binary from
Route events with jq rules
Every delivery to a webhook used to become a todo on that webhook's target queue — verbatim,
Run handoff work orders and difficulty lanes
This guide wires the rule packs. Once it is in place:
Attempt history
Every claim of a todo opens an attempt, and whatever ends that lease closes it with an
Routing cookbook
Tested recipes for the jq routing rules a webhook's owner sets. Every titled rule block on this
Working the queue well
A worker connected to a queue will get plenty of todos, and most of them are not work. This page
Security model
What switchboard protects, what it can't, and what is on you. Read this before you give an agent
Troubleshooting
Symptoms first, then the checks that separate their causes.
Run your own switchboard
Switchboard is a single Go binary and a PostgreSQL database. This guide takes you from nothing to a
Upgrading
This page documents the changes that need action when you move between Switchboard
Operator CLI reference
Every switchboard subcommand and flag, as the binary prints it. This page tracks
Change webhook routing safely
The operator workflow for editing a webhook's routing rules from the CLI:
Route runtime telemetry to a worker
A healthy OTLP receiver proves it accepts exports. Validate the rest of the