Auth & Account API

Registration, sign-in, email verification, password reset, OAuth, and the signed-in account.

These endpoints back the Livqeno dashboard and the CLI's raven login. Your own application's users never touch them — they authenticate against your app, and your backend mints them a token.

Endpoints

Method	Path	Credential
POST	`/v1/auth/login`	None
POST	`/v1/auth/logout`	Dashboard session (JWT)
POST	`/v1/auth/oauth/{provider}/exchange`	None
POST	`/v1/auth/oauth/{provider}/start`	None
GET	`/v1/auth/oauth/providers`	None
POST	`/v1/auth/password-reset`	None
POST	`/v1/auth/password-reset/confirm`	None
POST	`/v1/auth/register`	None
POST	`/v1/auth/verify-email`	None
POST	`/v1/auth/verify-email/resend`	Dashboard session (JWT)
GET	`/v1/onboarding`	None
PATCH	`/v1/onboarding`	None
POST	`/v1/onboarding/complete`	None
GET	`/v1/users/me`	None
PATCH	`/v1/users/me`	None

POST `/v1/auth/login`

Exchange email/password for a session JWT

Credential None · Rate limit 10 per window (details)

Parameter	In	Type	Required	Notes
`email`	body	`string`	Yes
`password`	body	`string`	Yes

POST `/v1/auth/logout`

Invalidate the current session JWT

Credential Dashboard session (JWT)

No parameters.

POST `/v1/auth/oauth/{provider}/exchange`

Complete an OAuth sign-in

Credential None · Rate limit 10 per window (details)

Parameter	In	Type	Required	Notes
`provider`	path	`string`	Yes
`code`	body	`string`	Yes	0–512 chars
`state`	body	`string`	Yes	0–128 chars

POST `/v1/auth/oauth/{provider}/start`

Begin an OAuth sign-in

Credential None · Rate limit 20 per window (details)

Parameter	In	Type	Required	Notes
`provider`	path	`string`	Yes

GET `/v1/auth/oauth/providers`

Which OAuth providers this deployment has configured

Credential None

No parameters.

POST `/v1/auth/password-reset`

Request a password-reset link

Credential None · Rate limit 5 per window (details)

Parameter	In	Type	Required	Notes
`email`	body	`string`	Yes

POST `/v1/auth/password-reset/confirm`

Set a new password using the token from a reset email

Credential None · Rate limit 5 per window (details)

Parameter	In	Type	Required	Notes
`token`	body	`string`	Yes	20–200 chars — The token from the link in the password-reset email.
`password`	body	`string`	Yes	8–72 chars

POST `/v1/auth/register`

Create a developer account

Credential None · Rate limit 5 per window (details)

Parameter	In	Type	Required	Notes
`email`	body	`string`	Yes
`password`	body	`string`	Yes	8–72 chars
`name`	body	`string`	No	0–120 chars

POST `/v1/auth/verify-email`

Confirm an email address using the token from a verification email

Credential None · Rate limit 10 per window (details)

Parameter	In	Type	Required	Notes
`token`	body	`string`	Yes	20–200 chars — The token from the link in the verification email.

POST `/v1/auth/verify-email/resend`

Send another verification link to the signed-in account

Credential Dashboard session (JWT) · Rate limit 3 per window (details)

No parameters.

GET `/v1/onboarding`

The signed-in user's onboarding state

Credential None

No parameters.

PATCH `/v1/onboarding`

Save onboarding progress

Credential None

Parameter	In	Type	Required	Notes
`step`	body	`number`	No
`useCases`	body	`string[]`	No	0–64 chars, array
`experienceLevel`	body	`string`	No	`getting-started` · `some-experience` · `experienced` · `production`
`stack`	body	`string[]`	No	0–64 chars, array
`createdFirstProject`	body	`boolean`	No

POST `/v1/onboarding/complete`

Mark onboarding finished

Credential None

No parameters.

GET `/v1/users/me`

The signed-in account

Credential None

No parameters.

PATCH `/v1/users/me`

Update the signed-in account profile

Credential None

Parameter	In	Type	Required	Notes
`name`	body	`string`	No	0–120 chars

Next steps

Conventions — base path, error envelope, request ids, pagination.
Errors — every code this API can return.
All endpoints — the whole surface on one page.