Skip to main content

Cloud authentication

Cloud requests use bearer authentication:
Authorization: Bearer vued_live_...
Accepted token types:
TokenUse
Supabase JWTFull user-session access.
Public API keyvued_live_... key scoped to one org and explicit scopes.
Most cloud routes are organization-scoped:
/v1/orgs/{org_id}/...
The SDK stores the default org on the client:
client = Vued(api_key="vued_live_...", org_id="org_uuid")

Public API key scopes

ScopeGrants
records:readRead fallback for meetings, transcripts, files, speakers, rooms, and users.
meetings:readMeeting audio and semantic meeting references.
transcripts:readSemantic search and transcript audio.
files:readFile and folder reads, grants, and downloads.
files:writeFile and folder create, update, grant, and revoke.
speakers:readSpeaker profile reads.
rooms:readRoom and microphone reads.
rooms:writeRoom create and update.
users:readOrganization user reads.
webhooks:readWebhook reads.
webhooks:writeWebhook create, update, and delete.
api_keys:readPublic API key reads.
api_keys:writePublic API key create and revoke.
org:<org_uuid>Restricts a key to one org.

Local desktop authentication

The desktop app writes a local discovery file that contains the local API URL and a runtime bearer token. The Python SDK reads this automatically. Discovery order:
  1. VUED_LOCAL_API_URL plus VUED_LOCAL_API_TOKEN
  2. VUED_LOCAL_API_DISCOVERY
  3. OS app-support local-api.json under Vued Dev, Vued, vued-web, or legacy Electron
Discovery file shape:
{
  "host": "127.0.0.1",
  "port": 39391,
  "pid": 12345,
  "version": 1,
  "profile": "prod",
  "authToken": "run-local-secret",
  "startedAt": 1782345600000
}
Never commit public API keys, local desktop tokens, webhook secrets, OAuth tokens, or .env files.
Last modified on June 29, 2026