Overview
Switchboard is the operator's board for inbound events. Many lines come in — webhooks from
Connect a provider
Using the hosted service? Providers are instance-wide and only the instance's operators can
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
The switchboard binary is not published for download. If you use the hosted service without a
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:
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