POST /api/user/v1/create/

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

{
  "status": 1,
  "status_description": "user_created",
  "response_body": {
    "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..."
  }
}

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

{
  "status": 1,
  "status_description": "user_created",
  "response_body": {
    "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..."
  }
}

This endpoint registers a new OTAS user. Provide the required name and credential fields in the JSON request body. On success the server returns the persisted user object together with a JWT that can be used immediately for authenticated requests. No prior authentication is needed to call this endpoint.

Request

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

Body parameters

string

required

The user’s first name.

string

required

The user’s last name.

string

required

A unique email address for the account. Must contain @. Stored in lowercase.

string

required

Account password. Minimum 6 characters. Stored hashed — never returned in responses.

string

Optional middle name.

Response

integer

required

1 on success, 0 on failure.

string

required

Human-readable result code. user_created on success.

object

Show properties

object

Show user properties

string

UUID of the newly created user.

string

First name as stored.

string

Middle name, or an empty string if not provided.

string

Last name as stored.

string

Lowercase email address.

string

ISO 8601 timestamp of account creation.

string

ISO 8601 timestamp of last update.

string

Signed JWT for the new user. Pass this in the X-OTAS-USER-TOKEN header for authenticated requests.

Example

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

{
  "status": 1,
  "status_description": "user_created",
  "response_body": {
    "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..."
  }
}

Error responses

`status_description`	HTTP status	Cause
`missing_fields: <names>`	400	One or more required fields are absent from the request body.
`invalid_email_format`	400	The `email` value does not contain `@`.
`password_too_short`	400	`password` is fewer than 6 characters.
`user_already_exists`	400	An account with the supplied email already exists.
`server_error: <detail>`	400	Unexpected server-side error.

UASAM — Users & Auth

UASAM — Projects & Keys

UASAM — Agents

Brain — Event Capture

Brain — Analytics

POST /api/user/v1/create/

Request

Body parameters

Response

Example

Error responses

​Request

​Body parameters

​Response

​Example

​Error responses

Request

Body parameters

Response

Example

Error responses