Create a user session

POSThttps://api.nuxie.ai/v1/tokens

Sign in with your Nuxie email and password to get a user session bearer token. Use that token to list your workspaces and create a workspace API key for your backend.

Your account must have an email/password login and a verified email address. This request does not need an existing API key.

Request body

emailbodystringrequired

Email address of your Nuxie account.

passwordbodystringrequired

Account password.

Response

objectstringrequired

token.

tokenstringrequired

User session bearer token. Keep this secret and send it as Authorization: Bearer <token> when managing workspace keys.

expires_atstringrequired

ISO 8601 session expiry time, or null if no time was returned.

userobjectrequired

Signed-in account.

User fields

idstringrequired

User ID.

emailstringrequired

Account email.

namestringrequired

Account name.

Use the session token for account and key-management requests. Your backend should use the workspace key it creates for ongoing workspace operations.

Errors

Status	Code	Action
`401`	`invalid_credentials`	Check the email and password.
`403`	`email_verification_required`	Verify the account’s email before trying again.
`429`	Rate limit	Wait before retrying sign-in.
`400`	`token_create_failed`	Read the response’s `error.message` for the failure.

End the session

Send DELETE /v1/tokens/current with this token as Authorization: Bearer <token>. A successful response contains object: "token" and revoked: true.

curl https://api.nuxie.ai/v1/tokens \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "you@example.com",
  "password": "your-account-password"
}'

{
  "object": "token",
  "token": "user-session-token",
  "expires_at": "2026-08-28T12:00:00.000Z",
  "user": {
    "id": "user-id",
    "email": "you@example.com",
    "name": "Your Name"
  }
}