action dracoon_update_user_account {
  label: "Update user account"
  description: "### Description:  \nUpdate current user's account.\n\n### Precondition:\nAuthenticated user.\n\n### Postcondition:\nUser's account is updated.\n\n### Further Information:\n* All input fields are limited to **150** characters.  \n* **All** characters are allowed.  \n\n`customer` (`CustomerData`) attribute in `UserAccount` response model is deprecated. Please use response from `GET /user/account/customer` instead."
  provider: dracoon
  method: PUT
  path: "/v4/user/account"
  encoding: json
  input: {
    type: "object"
    properties: {
      "X-Sds-Auth-Token": {
        type: "string"
      }
      "X-Sds-Date-Format": {
        type: "string"
        enum: ["UTC", "LOCAL", "OFFSET", "EPOCH", "LEET"]
      }
      acceptEULA: {
        type: "boolean"
        description: "Accept EULA\n\nPresent, if EULA is system global active.\n\ncf. `GET system/config/settings/general` - `eulaEnabled`\n\nIf accepted can not be undone."
      }
      email: {
        type: "string"
        description: "Email "
      }
      firstName: {
        type: "string"
        description: "User first name"
      }
      gender: {
        type: "string"
        description: "🚧 Deprecated since v4.12.0\n\nGender\n\nDo NOT use `gender`! It will be ignored."
      }
      language: {
        type: "string"
        description: "🚀 Since v4.20.0\n\nIETF language tag"
      }
      lastName: {
        type: "string"
        description: "User last name"
      }
      login: {
        type: "string"
        description: "🚧 Deprecated since v4.13.0\n\nUser login name"
      }
      phone: {
        type: "string"
        description: "Phone number"
      }
      title: {
        type: "string"
        description: "🚧 Deprecated since v4.18.0\n\nJob title"
      }
      userName: {
        type: "string"
        description: "🚀 Since v4.13.0\n\nUsername"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "User information"
    required: ["authData", "firstName", "hasManageableRooms", "id", "isLocked", "language", "lastName", "lockStatus", "needsToChangePassword", "userName", "userRoles"]
    properties: {
      authData: {
        type: "object"
        description: "User Authentication Data"
        required: ["method"]
        properties: {
          adConfigId: {
            type: "integer"
            format: "int32"
            description: "ID of the user's Active Directory."
          }
          login: {
            type: "string"
            description: "User login name"
          }
          method: {
            type: "string"
            description: "Authentication method\n\n\n\nAuthentication methods:\n\n* `basic`\n\n* `active_directory`\n\n* `radius`\n\n* `openid`"
          }
          mustChangePassword: {
            type: "boolean"
            description: "Determines whether user has to change his / her password\n\n* default: `true` for `basic` auth type\n\n* default: `false` for `active_directory`, `openid` and `radius` auth types"
          }
          oidConfigId: {
            type: "integer"
            format: "int32"
            description: "ID of the user's OIDC provider."
          }
          password: {
            type: "string"
            description: "Password (only relevant for `basic` authentication type)\n\n*NOT* your Active Directory, OpenID or RADIUS password!"
          }
        }
      }
      authMethods: {
        type: "array"
        description: "🚧 Deprecated since v4.13.0\n\nAuthentication methods:\n\n* `sql`\n\n* `active_directory`\n\n* `radius`\n\n* `openid`\n\nuse `authData` instead"
        items: {
          type: "object"
          description: "Authentication method"
          required: ["authId", "isEnabled"]
          properties: {
            authId: {
              type: "string"
              description: "Authentication method\n\n\n\nAuthentication methods:\n\n* `basic`\n\n* `active_directory`\n\n* `radius`\n\n* `openid`"
            }
            isEnabled: {
              type: "boolean"
              description: "Is enabled"
            }
            options: {
              type: "array"
              description: "Authentication method options"
              items: {
                type: "object"
                description: "Key-value pair"
                required: ["key", "value"]
                properties: {
                  key: {
                    type: "string"
                    description: "Entry key"
                  }
                  value: {
                    type: "string"
                    description: "Entry value"
                  }
                }
              }
            }
          }
        }
      }
      email: {
        type: "string"
        description: "Email "
      }
      expireAt: {
        type: "string"
        format: "date-time"
        description: "Expiration date"
      }
      firstName: {
        type: "string"
        description: "User first name"
      }
      gender: {
        type: "string"
        description: "🚧 Deprecated since v4.12.0\n\nGender"
      }
      hasManageableRooms: {
        type: "boolean"
        description: "User has manageable rooms"
      }
      homeRoomId: {
        type: "integer"
        format: "int64"
        description: "Homeroom ID"
      }
      id: {
        type: "integer"
        format: "int64"
        description: "Unique identifier for the user"
      }
      isEncryptionEnabled: {
        type: "boolean"
        description: "User has generated private key.\n\nPossible if client-side encryption is active for this customer"
      }
      isLocked: {
        type: "boolean"
        description: "User is locked:\n\n* `false` - unlocked\n\n* `true` - locked\n\n\n\nUser is locked and can not login anymore."
      }
      language: {
        type: "string"
        description: "🚀 Since v4.20.0\n\nIETF language tag"
      }
      lastLoginFailAt: {
        type: "string"
        format: "date-time"
        description: "Last failed logon date"
      }
      lastLoginFailIp: {
        type: "string"
        description: "🚧 Deprecated since v4.6.0\n\nLast failed logon IP address"
      }
      lastLoginSuccessAt: {
        type: "string"
        format: "date-time"
        description: "Last successful logon date"
      }
      lastLoginSuccessIp: {
        type: "string"
        description: "🚧 Deprecated since v4.6.0\n\nLast successful logon IP address"
      }
      lastName: {
        type: "string"
        description: "User last name"
      }
      lockStatus: {
        type: "integer"
        format: "int32"
        description: "🚧 Deprecated since v4.7.0\n\nUser lock status:\n\n* `0` - locked\n\n* `1` - Web access allowed\n\n* `2` - Web and mobile access allowed\n\n\n\nPlease use `isLocked` instead."
      }
      login: {
        type: "string"
        description: "🚧 Deprecated since v4.13.0\n\nUser login name"
      }
      mustSetEmail: {
        type: "boolean"
        description: "🚀 Since v4.13.0\n\nIf `true`, the user must set the `email` at the first login."
      }
      needsToAcceptEULA: {
        type: "boolean"
        description: "User has accepted EULA.\n\nPresent, if EULA is system global active.\n\ncf. `GET system/config/settings/general` - `eulaEnabled`"
      }
      needsToChangePassword: {
        type: "boolean"
        description: "🚧 Deprecated since v4.13.0\n\nDetermines whether user has to change his / her password"
      }
      needsToChangeUserName: {
        type: "boolean"
        description: "🚧 Deprecated since v4.13.0\n\nIf `true`, the user must change the `userName` at the first login."
      }
      phone: {
        type: "string"
        description: "Phone number"
      }
      title: {
        type: "string"
        description: "🚧 Deprecated since v4.18.0\n\nJob title"
      }
      userAttributes: {
        type: "object"
        description: "User custom attributes (list of key-value pairs)"
        required: ["items"]
        properties: {
          items: {
            type: "array"
            description: "List of key-value pairs"
            items: {
              type: "object"
              additionalProperties: true
            }
          }
        }
      }
      userGroups: {
        type: "array"
        description: "All groups the user is member of"
        items: {
          type: "object"
          description: "Group information"
          required: ["id", "isMember", "name"]
          properties: {
            id: {
              type: "integer"
              format: "int64"
              description: "Unique identifier for the group"
            }
            isMember: {
              type: "boolean"
              description: "Determines whether user is a member of the group or not"
            }
            name: {
              type: "string"
              description: "Group name"
            }
          }
        }
      }
      userName: {
        type: "string"
        description: "🚀 Since v4.13.0\n\nUsername"
      }
      userRoles: {
        type: "object"
        description: "List of roles"
        required: ["items"]
        properties: {
          items: {
            type: "array"
            description: "List of roles"
            items: {
              type: "object"
              description: "Role information"
              required: ["description", "id", "name"]
              properties: {
                description: {
                  type: "string"
                  description: "Role description"
                }
                id: {
                  type: "integer"
                  format: "int32"
                  description: "Unique identifier for the role"
                }
                items: {
                  type: "array"
                  description: "List of reachable right over role"
                  items: {
                    type: "object"
                    description: "Right information"
                    required: ["description", "id", "name"]
                    properties: {
                      description: {
                        type: "string"
                        description: "Right description"
                      }
                      id: {
                        type: "integer"
                        format: "int32"
                        description: "Unique identifier for the right"
                      }
                      name: {
                        type: "string"
                        description: "Right (unique) name"
                      }
                    }
                  }
                }
                name: {
                  type: "string"
                  description: "Role (unique) name"
                }
              }
            }
          }
        }
      }
    }
  }
}