Create Admin JWT (Self-Hosted)

curl --request POST \
  --url https://api.usedatabrain.com/api/v2/admin-account/jwt \
  --header 'Content-Type: application/json' \
  --data '{"email":"admin@company.com","password":"SecureP@ss1"}'

{
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

curl --request POST \
  --url https://api.usedatabrain.com/api/v2/admin-account/jwt \
  --header 'Content-Type: application/json' \
  --data '{"email":"admin@company.com","password":"SecureP@ss1"}'

{
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

curl --request POST \
  --url https://api.usedatabrain.com/api/v2/admin-account/jwt \
  --header 'Content-Type: application/json' \
  --data '{"email":"admin@company.com","password":"SecureP@ss1"}'

{
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

POST

api

admin-account

jwt

curl --request POST \
  --url https://api.usedatabrain.com/api/v2/admin-account/jwt \
  --header 'Content-Type: application/json' \
  --data '{"email":"admin@company.com","password":"SecureP@ss1"}'

{
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

Sign in with an existing admin email and password to receive a JWT access token. Use this token in the Authorization header when calling admin-only endpoints such as Create Service Token, Rotate Service Token, and Reset Admin Password.

Self-Hosted Only: This endpoint is available only on self-hosted Databrain instances.

Headers

Content-Type

string

required

Must be application/json when sending a JSON body.

Content-Type: application/json

Request Body

string

required

Admin user’s email address. Must be a valid email with at least two domain segments.

password

string

required

Admin user’s password.

Response

On success, the API returns 200 with a JSON object:

data

object

Wrapper object for the response payload.

data.accessToken

string

JWT access token. Use as Authorization: Bearer <accessToken> for admin and service-token APIs.

On error, the API returns a JSON object with error.code and error.message and an appropriate HTTP status (400 or 500).

Examples

HTTP Status Code Summary

Status Code	Description
`200`	OK – Access token returned in `data.accessToken`
`400`	Bad Request – Invalid credentials or validation error
`500`	Internal Server Error – Server error or self-hosted-only error

Possible Errors

Code	Message	HTTP Status
`USER_NOT_FOUND`	No User found with the given email	400
`Invalid credentials`	Invalid credentials (when password is incorrect or login fails)	400
`SELFHOSTED_APP_ERROR`	This feature is only available for self-hosted instances	500
`INTERNAL SERVER ERROR`	Connection Failure	500

Create Admin Account – Create the first admin account
Create Service Token – Create a service token (requires this JWT)
Reset Admin Password – Change admin password (requires this JWT)

Create Admin Account (Self-Hosted)

Create Service Token (Self-Hosted)

Documentation Index

​Headers

​Request Body

​Response

​Examples

​HTTP Status Code Summary

​Possible Errors

​Related

Headers

Request Body

Response

Examples

HTTP Status Code Summary

Possible Errors

Related