Auth
POST /v1/auth/verify
Submit the emailed OTP code (no auth required). First-time: makes workspace durable. Repeat: key recovery (returns new apiKey).
POST /v1/auth/verifySubmit the emailed OTP code (no auth required). First-time: makes workspace durable. Repeat: key recovery (returns new apiKey).
Auth: none (public endpoint)
Body fields
| Name | Required | Notes |
|---|---|---|
email | yes | |
code | yes |
Example
curl -X POST 'https://brain.unisonlabs.ai/v1/auth/verify' \
-H "Authorization: Bearer $UNISON_TOKEN" \
-H 'content-type: application/json' \
-d '{"email": "...", "code": "..."}'Returns the JSON described above on success, or an error envelope { "error": { "code", "message" } } on failure.
POST /v1/auth/provision
Create a headless account for an email and return a usk_ key (no auth required). If the email has a pending invitation, joins that workspace instead of creating a new one.
POST /v1/auth/request-key
Send a recovery OTP to a verified email (no auth required); the following /verify mints a new key.