Authentication (draft)

Endpoint for AUTH (Get)

/auth

Responses

Authenticate a user account.

/auth

Authenticate a user account.

Request parameters

{
  "username": "email@example.com",
  "password": "example",
  "recaptchaResponse": "example",
  "mfa_token": "example"
}

Responses

{
  "id": 96,
  "username": "email@example.com",
  "data": {
    "firstname": "Geoff",
    "lastname": "Rey"
  },
  "status": "ACTIVE",
  "dateCreated": 1736505915,
  "dateModified": 1736505915,
  "isRegistered": true,
  "lastLogin": 1736505915,
  "mfaEnabled": [
    "google"
  ],
  "parentId": 96,
  "permissions": [
    96
  ],
  "zone": 96,
  "zones": [
    {
      "id": 1,
      "name": "Default"
    }
  ]
}

Endpoint for AUTH (Delete)

/auth

Responses

Authenticate using a token

/token-auth

Responses

Retrieve the current authenticated user account.

/emulate

Retrieve the current authenticated user account.

Request parameters

Responses

{
  "id": 96,
  "username": "email@example.com",
  "data": {
    "firstname": "Geoff",
    "lastname": "Rey"
  },
  "status": "ACTIVE",
  "dateCreated": 1736505915,
  "dateModified": 1736505915,
  "isRegistered": true,
  "lastLogin": 1736505915,
  "mfaEnabled": [
    "google"
  ],
  "parentId": 96,
  "permissions": [
    96
  ],
  "zone": 96,
  "zones": [
    {
      "id": 1,
      "name": "Default"
    }
  ]
}

Emulate another user (Admin only)

/emulate

Responses

Endpoint for EMULATE (Delete)

/emulate

Responses

Endpoint for LOGIN-HISTORY (Get)

/login-history

Responses

null

Reset password with token

/password-reset

Responses

Request a password reset email

/password-reset-request

Responses

Unlock account with token

/account-unlock

Responses

User registration

/register

Responses

01 September 2026