Auth

GET /v1/auth/whoami

Return the authenticated user, workspace, and scopes for the presented key. When delegated (X-Unison-Actor), includes actedAs: { externalId, userId }.

unison-brain

GET /v1/auth/whoami

Return the authenticated user, workspace, and scopes for the presented key. When delegated (X-Unison-Actor), includes actedAs: { externalId, userId }.

Required scope: brain:read

Example

curl -X GET 'https://brain.unisonlabs.ai/v1/auth/whoami' \
  -H "Authorization: Bearer $UNISON_TOKEN"

Returns the JSON described above on success, or an error envelope { "error": { "code", "message" } } on failure.

POST /v1/auth/request-key

Send a recovery OTP to a verified email (no auth required); the following /verify mints a new key.

GET /v1/auth/workspaces

List all workspaces the caller is a member of, with their role and which is active.