POST /api/user/v1/login/

curl --request POST \
  --url http://localhost:8000/api/user/v1/login/ \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "ada@example.com",
    "password": "securepassword"
  }'

{
  "status": 1,
  "status_description": "login_success",
  "response": {
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "first_name": "Ada",
      "middle_name": "",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "created_at": "2026-04-16T10:00:00.000000",
      "updated_at": "2026-04-16T10:00:00.000000"
    },
    "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

{
  "status": 0,
  "status_description": "login_failed"
}

curl --request POST \
  --url http://localhost:8000/api/user/v1/login/ \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "ada@example.com",
    "password": "securepassword"
  }'

{
  "status": 1,
  "status_description": "login_success",
  "response": {
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "first_name": "Ada",
      "middle_name": "",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "created_at": "2026-04-16T10:00:00.000000",
      "updated_at": "2026-04-16T10:00:00.000000"
    },
    "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

{
  "status": 0,
  "status_description": "login_failed"
}

This endpoint validates an email and password combination and returns a signed JWT on success. Pass the returned jwt_token value in the X-OTAS-USER-TOKEN header for any endpoint that requires authentication. No prior authentication is needed to call this endpoint.

The request body accepts either password or Password (capital P) for the password field. Both keys are checked; Password takes precedence if both are present.

Request

Method: POST
URL: http://localhost:8000/api/user/v1/login/
Authentication: None

Body parameters

string

required

The registered email address. Matched case-insensitively.

string

required

Account password. Also accepted as Password (capital P).

Response

integer

required

1 on success, 0 on failure.

string

required

login_success on success, login_failed on failure.

object

Present only on a successful login.

Show properties

object

Show user properties

string

UUID of the authenticated user.

string

User’s first name.

string

User’s middle name, or empty string.

string

User’s last name.

string

Lowercase email address.

string

ISO 8601 timestamp of account creation.

string

ISO 8601 timestamp of last update.

string

Signed JWT. Supply this as the X-OTAS-USER-TOKEN header in subsequent requests.

Example

curl --request POST \
  --url http://localhost:8000/api/user/v1/login/ \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "ada@example.com",
    "password": "securepassword"
  }'

{
  "status": 1,
  "status_description": "login_success",
  "response": {
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "first_name": "Ada",
      "middle_name": "",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "created_at": "2026-04-16T10:00:00.000000",
      "updated_at": "2026-04-16T10:00:00.000000"
    },
    "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

{
  "status": 0,
  "status_description": "login_failed"
}

Error responses

`status_description`	HTTP status	Cause
`login_failed`	401	Invalid credentials, missing fields, or unexpected server error.

UASAM — Users & Auth

UASAM — Projects & Keys

UASAM — Agents

Brain — Event Capture

Brain — Analytics

POST /api/user/v1/login/

Request

Body parameters

Response

Example

Error responses

​Request

​Body parameters

​Response

​Example

​Error responses

Request

Body parameters

Response

Example

Error responses