Lightspeed · JSON Structure

Restaurant K Series Staff Api Update Pos Staff Dto Structure

staff-apiUpdatePosStaffDto schema from Lightspeed Restaurant K Series API

Type: object Properties: 9 Required: 8

POSRetailRestaurantEcommerce

staff-apiUpdatePosStaffDto is a JSON Structure definition published by Lightspeed, describing 9 properties, of which 8 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

username pinCode firstName lastName active visible group reportAccess roles

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/lightspeed-pos/refs/heads/main/json-structure/restaurant-k-series-staff-api-update-pos-staff-dto-structure.json",
  "name": "staff-apiUpdatePosStaffDto",
  "description": "staff-apiUpdatePosStaffDto schema from Lightspeed Restaurant K Series API",
  "type": "object",
  "properties": {
    "username": {
      "description": "The staff username. Only used for POS staff.",
      "type": "string",
      "x-nonempty": true,
      "maxLength": 128,
      "example": "John Doe"
    },
    "pinCode": {
      "type": "string",
      "maxLength": 4,
      "description": "The 4-digit pin code for the user.",
      "example": "1234"
    },
    "firstName": {
      "type": "string",
      "maxLength": 128,
      "description": "The first name of the user.",
      "example": "John"
    },
    "lastName": {
      "type": "string",
      "maxLength": 128,
      "description": "The last name of the user.",
      "example": "Doe"
    },
    "active": {
      "type": "boolean",
      "description": "Indicates if the user is active."
    },
    "visible": {
      "type": "boolean",
      "description": "Indicates if the user is visible."
    },
    "group": {
      "type": "int64",
      "default": -1,
      "x-positive-number-required": true,
      "description": "The unique identifier for the user group."
    },
    "reportAccess": {
      "type": "string",
      "description": "User report permissions."
    },
    "roles": {
      "type": "array",
      "x-default-null": true,
      "description": "The roles assigned to the user.",
      "items": {
        "type": "string",
        "description": "List of roles assigned to the user. Normally, these are the default POS user roles. See [Get All POS User Permissions](https://api-docs.lsk.lightspeed.app/operation/operation-staff-apigetposuserpermissions) for a list of roles."
      }
    }
  },
  "required": [
    "username",
    "pinCode",
    "firstName",
    "lastName",
    "active",
    "visible",
    "reportAccess",
    "roles"
  ]
}