Description:
Retrieve detailed information about a user group.
Precondition:
Right 🔓 read groups required.
Postcondition:
User group is returned.
Further Information:
None.
643 matches
100 actions
DRACOON
100 actions
Infrastructure/DRACOON
Retrieve detailed information about a user group.
Right 🔓 read groups required.
User group is returned.
None.
{
"type": "object",
"properties": {
"X-Sds-Auth-Token": {
"type": "string"
},
"X-Sds-Date-Format": {
"type": "string",
"enum": [
"UTC",
"LOCAL",
"OFFSET",
"EPOCH",
"LEET"
]
},
"group_id": {
"type": "integer",
"format": "int64"
}
},
"required": [
"group_id"
],
"additionalProperties": false
}{
"type": "object",
"description": "Group information",
"required": [
"cntUsers",
"createdAt",
"createdBy",
"id",
"name"
],
"properties": {
"cntUsers": {
"type": "integer",
"format": "int32",
"description": "Amount of users"
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "Creation date"
},
"createdBy": {
"type": "object",
"description": "User information",
"required": [
"avatarUuid",
"firstName",
"id",
"lastName",
"userName",
"userType"
],
"properties": {
"avatarUuid": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nAvatar UUID"
},
"displayName": {
"type": "string",
"description": "🚧 Deprecated since v4.11.0\n\nDisplay name\n\nuse other fields from `UserInfo` instead to combine a display name"
},
"email": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nEmail "
},
"firstName": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nUser first name (mandatory if `userType` is `internal`)"
},
"id": {
"type": "integer",
"format": "int64",
"description": "Unique identifier for the user"
},
"lastName": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nUser last name (mandatory if `userType` is `internal`)"
},
"title": {
"type": "string",
"description": "🚧 Deprecated since v4.18.0\n\nJob title"
},
"userName": {
"type": "string",
"description": "🚀 Since v4.13.0\n\nUsername (only returned for `internal` users)"
},
"userType": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nUser type:\n\n* `internal` - ordinary DRACOON user\n\n* `external` - external user without DRACOON account\n\n* `system` - system user (non human 👽)\n\n* `deleted` - deleted DRACOON user",
"enum": [
"system",
"internal",
"external",
"deleted"
]
}
}
},
"expireAt": {
"type": "string",
"format": "date-time",
"description": "Expiration date"
},
"groupRoles": {
"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"
}
}
}
}
}
},
"id": {
"type": "integer",
"format": "int64",
"description": "Unique identifier for the group"
},
"name": {
"type": "string",
"description": "Group name"
},
"updatedAt": {
"type": "string",
"format": "date-time",
"description": "Modification date"
},
"updatedBy": {
"type": "object",
"description": "User information",
"required": [
"avatarUuid",
"firstName",
"id",
"lastName",
"userName",
"userType"
],
"properties": {
"avatarUuid": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nAvatar UUID"
},
"displayName": {
"type": "string",
"description": "🚧 Deprecated since v4.11.0\n\nDisplay name\n\nuse other fields from `UserInfo` instead to combine a display name"
},
"email": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nEmail "
},
"firstName": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nUser first name (mandatory if `userType` is `internal`)"
},
"id": {
"type": "integer",
"format": "int64",
"description": "Unique identifier for the user"
},
"lastName": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nUser last name (mandatory if `userType` is `internal`)"
},
"title": {
"type": "string",
"description": "🚧 Deprecated since v4.18.0\n\nJob title"
},
"userName": {
"type": "string",
"description": "🚀 Since v4.13.0\n\nUsername (only returned for `internal` users)"
},
"userType": {
"type": "string",
"description": "🚀 Since v4.11.0\n\nUser type:\n\n* `internal` - ordinary DRACOON user\n\n* `external` - external user without DRACOON account\n\n* `system` - system user (non human 👽)\n\n* `deleted` - deleted DRACOON user",
"enum": [
"system",
"internal",
"external",
"deleted"
]
}
}
}
}
}