API Docs / Schemas / RoleDto

RoleDto

A custom (tenant-defined) role and the capabilities it grants per entity.

Properties

Name Type Description
codestring

The unique code identifying this role

The unique code identifying this role

namestring

The display name of the role

The display name of the role

descriptionstring

Optional description of what this role is for

Optional description of what this role is for

assignedUserCountinteger

The number of users currently assigned to this role

The number of users currently assigned to this role

permissionsobject

The capabilities granted per entity. Each entry lists the granted capabilities individually —
there is no implicit hierarchy; an entry containing "Admin" grants every capability on that
entity. Entities granting nothing are omitted.

The capabilities granted per entity. Each entry lists the granted capabilities individually —
there is no implicit hierarchy; an entry containing "Admin" grants every capability on that
entity. Entities granting nothing are omitted.

createdDatestring

When the role was created

When the role was created

updatedDatestring

When the role was last updated

When the role was last updated

JSON Example

{
  "code": "string",
  "name": "string",
  "description": "string",
  "assignedUserCount": 0,
  "permissions": {
    "Tasks": [
      "..."
    ],
    "Users": [
      "..."
    ],
    "Clients": [
      "..."
    ],
    "Contacts": [
      "..."
    ],
    "ClientContacts": [
      "..."
    ]
  }
}

Used By Operations

Contained in Schemas