UnisonI lost my API key. How do I get it back?
Recover a lost Unison API key using the request-key endpoint — no data is lost.
I lost my usk_live_... key. Is my data gone?
No. Your brain data is stored against your account (identified by email), not against the key itself. You can request a new key at any time — everything in the brain stays intact.
Recover your key
curl -X POST https://brain.unisonlabs.ai/v1/auth/request-key \
-H 'content-type: application/json' \
-d '{"email": "you@example.com"}'This emails a recovery OTP to the address associated with your account. Verify it the same way as initial provisioning:
curl -X POST https://brain.unisonlabs.ai/v1/auth/verify \
-H 'content-type: application/json' \
-d '{"email": "you@example.com", "code": "654321"}'The response contains your key. Update it wherever it's stored.
If you think the key was exposed
Don't just recover — rotate. The recovery flow above gets you back into your account when you've lost access; rotation (minting a new key, then revoking the old) is what you want when a key may have been compromised, because it invalidates the exposed credential. See Rotating keys for the rotation flow.
How do I authenticate in CI or a headless environment?
Provision a Unison API key non-interactively for use in CI pipelines, background workers, and automated scripts.
How do I give each end-user their own private memory?
Use the brain:act-as scope and a per-call actor ID to create isolated private memory for every user in your application.