switchboard · account
Account
Keys and profile for your Switchboard account. Usage, balance, and groups live at /platform/switchboard.
Application keys
An application key authenticates your app to Switchboard. Every prompt your app sends must be signed with one. Keys are a shared pool for your account: mint as many as you need, and revoking one doesn't interrupt your end users, who keep working through any remaining key. The plaintext is shown once at mint, so save it.
Admin keys
Bearer swb_admin_… keys your backend uses to provision end users and mint application keys programmatically, no dashboard round-trip per user. Server-side only; never ship one to a browser or app. The plaintext is shown once at mint, so save it.
Using an admin key
From your backend, on each of your users' signup:
# provision the end-user (idempotent, safe to call every login)
curl -X POST https://api.valni.app/v1/switchboard/end-users \
-H "Authorization: Bearer swb_admin_…" \
-d '{"endUserId":"your-user-id"}'
# mint an end-user-scoped application key for that user's client app
curl -X POST https://api.valni.app/v1/switchboard/keys \
-H "Authorization: Bearer swb_admin_…" \
-d '{"name":"ios-app","endUserId":"your-user-id"}'Devices
Terminals and tools signed in to your account with a session, like pi. Each device holds only short-lived credentials and books usage to its own end user. Revoking a device signs it out within minutes without touching your keys or other devices.
Profile
How you use Switchboard, so invoices and receipts show the right name.
Complete your profile to start minting application keys.
Preview:
Create a test end user
Trying Switchboard or the demo app? Create an end user here, mint an application key, and you're ready to send your first request, no backend required. In production, your backend provisions end users through the Admin API.