Developers

Build regulated voice workflows with SOMVAD

Start with the quickstart, inspect the API contract, test in the sandbox, and use the workflow guides to build custom operator experiences. Everything the SOMVAD console does, it does through this public API, and so can you.

Start the quickstart Open the API explorer

Quickstart

Authenticate, place a call, and join a conference from the browser. One happy path, kept short.

Read →

API reference

An OpenAPI 3.1 contract across 138 endpoints and 30 domains. Request and response shapes, auth, errors.

Read →

SDKs

Typed TypeScript: a headless core, React hooks, and the design system the console itself is built from.

Read →

Workflow recipes

End-to-end builds (trader desk, supervisor panel, command console) with AI agent prompt starters.

Read →

Build with AI coding agents

SOMVAD is spec-friendly and agent-friendly

Developers no longer read docs alone. They read them with an assistant. The whole platform is described by one machine-readable OpenAPI contract, so Claude Code, Replit Agent, or Lovable can understand the API, generate a typed client, and build operator surfaces against the same source of truth your engineers use.

Every workflow recipe ships with a build order and a copy-paste prompt starter, plus a note on what the agent still needs from you.

See agent recipes

Point your agent at the contract

# the machine contract, versioned, regenerated on every change
curl https://dev.somvad.com/openapi.json

# the prose guide: workflows, event frames, state machines
curl https://dev.somvad.com/devguide

Links & portals

Every surface and machine endpoint, in one place

Resource	Where	What
API explorer	`/docs`	Interactive Swagger UI over the live OpenAPI
OpenAPI spec	`/openapi.json`	The machine contract: codegen and agents
Developer guide	`/devguide`	Prose: workflows, event frames, state machines
Events WebSocket	`wss://<host>/presence/ws`	Presence, chat, signals, line state: one socket
Browser SIP config	`GET /browser/config`	Per-call SIP credential + ICE/TURN servers
Health	`/health`	Liveness, open and unauthenticated

Live deployment: https://dev.somvad.com. The API accepts a normal bearer token (Authorization: Bearer …); /devguide, /docs, and /openapi.json also accept ?token=.