643 matches
100 actions
DRACOON
100 actions
Infrastructure/DRACOON
Update current user's account.
Authenticated user.
User's account is updated.
customer (CustomerData) attribute in UserAccount response model is deprecated. Please use response from GET /user/account/customer instead.
{
"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
}{
"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",
"description": "Key-value pair",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"description": "Entry key"
},
"value": {
"type": "string",
"description": "Entry value"
}
}
}
}
}
},
"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"
}
}
}
}
}
}
}
}