UserInput

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/UserInput",
  "title": "UserInput",
  "type": "object",
  "description": "Input for creating or updating a user.",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "User identifier."
    },
    "name": {
      "type": "string",
      "description": "User display name.",
      "maxLength": 256
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "User email address."
    },
    "password": {
      "type": "string",
      "format": "password",
      "description": "User password."
    },
    "role": {
      "type": "string",
      "description": "User service role.",
      "enum": [
        "User",
        "Power User",
        "Service Administrator"
      ]
    },
    "groups": {
      "type": "array",
      "description": "Group names to assign the user to.",
      "items": {
        "type": "string"
      }
    }
  }
}