Account & Keys API

Save Provider Key

POST /v1/account/keys
{
  "provider": "openai",
  "apiKey": "sk-...",
  "model": "text-embedding-3-small",
  "dimensions": 1024,
  "baseUrl": "https://openrouter.ai/api/v1"  // optional
}

The key is validated with a test embedding call. Returns the validated model and dimensions.

Delete Provider Key

DELETE /v1/account/keys/:provider

Set Default Provider

PUT /v1/account/keys/:provider/default

Get Usage

GET /v1/account/usage

Returns tenant info, usage counters, provider list, and embedding dimensions.

Reset Dimensions

DELETE /v1/account/dimensions

Warning: This deletes all your memories, vectors, and provider keys. Use only if you need to switch to a different embedding dimension.

Auth Endpoints (Public)

• POST /v1/auth/magic-link — send magic link email
• GET /v1/auth/verify?token=... — verify and get API key