Employee login

This endpoint documentation is generated directly from openapi.yaml.

Endpoint

POST /auth/employee/login

Operation

Operation ID: employeeLogin

Authenticate an employee using user ID and password

Authentication

No authentication required.

Request Body

Required: yes.

Content type: application/json

{
  "properties": {
    "g_recaptcha_response": {
      "description": "reCAPTCHA verification token",
      "type": "string"
    },
    "password": {
      "description": "Employee password",
      "format": "password",
      "type": "string"
    },
    "user_id": {
      "description": "Employee user ID",
      "example": 1,
      "type": "integer"
    }
  },
  "required": [
    "user_id",
    "password",
    "g_recaptcha_response"
  ],
  "type": "object"
}
        

Responses

Status	Description	Content Types
200	Login successful	application/json
400
401

Schema for response 200 (application/json):

{
  "oneOf": [
    {
      "properties": {
        "token": {
          "description": "Bearer authentication token",
          "type": "string"
        }
      },
      "required": [
        "token"
      ],
      "type": "object"
    },
    {
      "properties": {
        "2fa_required": {
          "example": true,
          "type": "boolean"
        },
        "2fa_token": {
          "description": "Temporary 2FA verification token",
          "type": "string"
        }
      },
      "required": [
        "2fa_required",
        "2fa_token"
      ],
      "type": "object"
    }
  ]
}
        

17 March 2026