Loading

DFS Admin Services API (latest)

Download OpenAPI specification:

Administration Services

AccessPolicyManagement

Access-Policies Management API

Access policies

Retrieves all the access policies associated to the client apps in the context of a specified api resource.

Authorizations:
Bearer
path Parameters
resource
required
string

The api resource associated to the access policies that clients have access to.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Result": "success",
  • "AccessPolicies": {
    }
}

Identity roles with authorization access policies

Retrieves all the identity roles with theirs associates authorization access policies in the context of the current tenant.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Result": "success",
  • "IdentityRoles": [
    ]
}

Retrieve a list of API access policies.

Retrieves a list of API access policies.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "accessPolicies": [
    ]
}

Retrieve a specific access policy.

Retrieve a specific access policy.

Authorizations:
Bearer
path Parameters
accessPolicyId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "key": "string",
  • "name": "string",
  • "description": "string",
  • "isAppOriented": true,
  • "requiredByPermissions": [
    ]
}

Retrieve a list of available system-wide permissions.

Retrieve a list of available system-wide permissions.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "results": [
    ]
}

Retrieve information on a specific permission.

Retrieve information on a specific permission.

Authorizations:
Bearer
path Parameters
permissionId
required
integer <int32>

The permission id.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "uid": "07cc67f4-45d6-494b-adac-09b5cbc7e2b5",
  • "name": "string",
  • "hierarchyPath": [
    ],
  • "requiredAccessPolicies": [
    ]
}

Check if a role has sufficient access policies for the specified permissions.

Check if a role has sufficient access policies for the specified permissions.

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

Role id to check.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Permissions to check.

permissionsUids
Array of strings or null <uuid> [ items <uuid > ]

Responses

Request samples

Content type
{
  • "permissionsUids": [
    ]
}

Response samples

Content type
application/json
{
  • "isSufficient": true,
  • "missingAccessPolicies": [
    ]
}

BackOfficeManagement

Back-Office Management API

Get a identity provider setting by provider id

Authorizations:
Bearer
path Parameters
providerId
required
integer <int32>
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Id": 1,
  • "ProviderId": 1,
  • "ProviderTypeId": 1,
  • "Name": "Idsrv",
  • "DisplayName": "DFS.Identity",
  • "IsEnabled": true,
  • "IsDefault": true,
  • "CreatedDate": "2026-03-25T09:56:22.1863108Z",
  • "LastUpdatedDate": "2026-03-25T09:56:22.1863109Z"
}

Retrieve a list of accessible (B/O) menu items and functionality.

Retrieves a list of (B/O) menu items and functionality accessible by identities under an identity-role in a specific tenant.

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The role id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "DefaultMenuItemId": 2453,
  • "MenuItemIds": [
    ],
  • "FunctionalityIds": [
    ]
}

Set a list of accessible (B/O) menu items and functionality.

Sets a list of (B/O) menu items and functionality accessible by identities under an identity-role in a specific tenant.

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The identity role ID

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The set identity tenant functionalities and menu items payload

defaultMenuItemId
integer or null <int32>
menuItemIds
Array of integers or null <int32> [ items <int32 > ]
functionalityIds
Array of integers or null <int32> [ items <int32 > ]

Responses

Request samples

Content type
{
  • "DefaultMenuItemId": 2453,
  • "MenuItemIds": [
    ],
  • "FunctionalityIds": [
    ]
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve a list of available (B/O) menu items and functionality.

Retrieves a list of available (B/O) menu items and functionality.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "MenuItems": [
    ],
  • "FunctionalityGroups": [
    ]
}

Retrieve a list of accessible (B/O) menu items and functionality Deprecated

This API is deprecated

Retrieves a list of (B/O) menu items and functionality accessible by specific identity in a specific tenant. Note that identity specific permissions override role permissions.

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "DefaultMenuItemId": 12,
  • "MenuItemIds": [
    ],
  • "FunctionalityIds": [
    ]
}

Set a list of accessible (B/O) menu items and functionality Deprecated

This API is deprecated

Sets a list of (B/O) menu items and functionality accessible by a specific identity in a specific tenant. Note that identity specific permissions override role permissions

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The set identity tenant functionalities and menu items payload

defaultMenuItemId
integer or null <int32>
menuItemIds
Array of integers or null <int32> [ items <int32 > ]
functionalityIds
Array of integers or null <int32> [ items <int32 > ]

Responses

Request samples

Content type
{
  • "DefaultMenuItemId": 11,
  • "MenuItemIds": [
    ],
  • "FunctionalityIds": [
    ]
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

IdentityManagement

Identity Management API

Delete identity picture

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Get identity picture

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "ImageContentBase64": "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",
  • "IsDefaultImage": false
}

Upload identity picture

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The picture represented as base64 string

imageContentBase64
string or null

Responses

Request samples

Content type
{
  • "ImageContentBase64": "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"
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Get the identity by Internal User ID

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "MemberId": 1,
  • "IdentityId": "01000000-0000-0000-0000-000000000000",
  • "UserName": "additiv",
  • "FirstName": "Admin",
  • "LastName": "Admin",
  • "SalutationId": 2,
  • "Email": "admin@additiv.com",
  • "Description": "Admin account description",
  • "Phone": "41|522672742",
  • "Mobile": "41|797353960",
  • "IdentityProviderSettingId": 1,
  • "ExternalId": "EX001245",
  • "IdentityRole": {
    },
  • "IdentityProvider": {
    },
  • "BankBranch": {
    },
  • "IsSignInEnabled": true,
  • "IsTenantAccessEnabled": true,
  • "AssignedContactsCount": 2,
  • "ParticipantIds": [
    ]
}

Retrieves a list of API access policies available to the identity passed

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "accessPolicies": [
    ]
}

Get all the identities and their roles (including hierarchy level)

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get member-role hierarchy by Internal ID

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal ID of an identity of the Base element of the Member Role Hierarchy

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Superiors": [
    ],
  • "Base": {
    },
  • "HierarchyItems": [
    ]
}

Validate whether an identity has access to a contact, member or legal entity (defined by personId)

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Identity ID of the user that is trying to access Person ID

personId
required
integer <int32>

The accessed Person ID

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
true

Validate whether an identity has access to a contact, member or legal entity (defined by personId)

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Identity ID of the user that is trying to access Person ID

personUId
required
string <uuid>

The accessed Person unique ID

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
true

Update the identity with specified Internal User ID

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The update identity payload

updateProperties
Array of strings or null unique
firstName
string or null
lastName
string or null
salutationId
integer or null <int32>
email
string or null
description
string or null
phone
string or null
mobile
string or null
url
string or null
bankBranchId
integer or null <int32>
identityRoleId
integer <int32>
externalId
string or null
userName
string or null
object (ResetPasswordRequest)
object (ChangePasswordRequest)
isSignInEnabled
boolean
isTenantAccessEnabled
boolean
participantIds
Array of integers or null <int32> [ items <int32 > ]

Responses

Request samples

Content type
{
  • "FirstName": "Sarah",
  • "LastName": "Connor",
  • "SalutationId": 1,
  • "Email": "sconnor@additiv.com",
  • "Description": "Sarah Connor account description",
  • "Phone": "41|9379992",
  • "Mobile": "41|0480003",
  • "BankBranchId": 2,
  • "IdentityRoleId": 1,
  • "ExternalId": "0001EXT-F",
  • "UserName": "sconn",
  • "ResetPassword": {
    },
  • "ChangePassword": {
    },
  • "IsSignInEnabled": true,
  • "IsTenantAccessEnabled": true,
  • "ParticipantIds": [
    ],
  • "UpdateProperties": [
    ]
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Set the access to the tenant (including role)

Authorizations:
Bearer
path Parameters
tenantId
required
integer <int32>

The Tenant ID

identityId
required
string <uuid>

The Internal User ID of an identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The set identity tenant access payload

tenantId
integer <int32>
identityRoleId
integer or null <int32>
isEnabled
boolean

Responses

Request samples

Content type
{
  • "TenantId": 12,
  • "IdentityRoleId": 1,
  • "IsEnabled": true
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Search the identities by given search criteria.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The search criteria

page
integer <int32>
pageSize
integer <int32>
sortBy
string or null
sortOrder
string (SortOrder)
Enum: "Ascending" "Descending"
roleIds
Array of integers or null <int32> [ items <int32 > ]
identityIds
Array of strings or null <uuid> [ items <uuid > ]
participantIds
Array of integers or null <int32> [ items <int32 > ]
firstName
string or null
lastName
string or null
searchTerm
string or null
searchIdentityBy
string (SearchIdentityBy)
Enum: "FirstName" "LastName" "UserName" "Email" "IdentityProviderName" "RoleName" "FullName" "All"
searchByAllTenants
boolean
searchByInactive
boolean
searchBySystemAccounts
boolean

Responses

Request samples

Content type
{
  • "RoleIds": [
    ],
  • "IdentityIds": [
    ],
  • "ParticipantIds": [
    ],
  • "FirstName": "Admin",
  • "LastName": "Admin",
  • "SearchTerm": "ad",
  • "SearchIdentityBy": "All",
  • "SearchByAllTenants": true,
  • "SearchByInactive": true,
  • "SearchBySystemAccounts": false,
  • "SortBy": "LastName",
  • "SortOrder": "Descending",
  • "Page": 1,
  • "PageSize": 10
}

Response samples

Content type
application/json
{
  • "Results": [
    ],
  • "Page": 1,
  • "PageSize": 10,
  • "PageCount": 1,
  • "TotalCount": 2
}

Create a new identity

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The create/add identity payload

firstName
string or null
lastName
string or null
salutationId
integer or null <int32>
email
string or null
description
string or null
phone
string or null
mobile
string or null
url
string or null
bankBranchId
integer or null <int32>
identityRoleId
integer <int32>
externalId
string or null
username
string or null
password
string or null
participantIds
Array of integers or null <int32> [ items <int32 > ]

Responses

Request samples

Content type
{
  • "FirstName": "John",
  • "LastName": "Connor",
  • "SalutationId": 2,
  • "Email": "jct@additiv.com",
  • "Description": "John Connor account description",
  • "Phone": "41|522672742",
  • "Mobile": "41|633783853",
  • "BankBranchId": 1,
  • "IdentityRoleId": 1,
  • "ExternalId": "EX006D34-9",
  • "Username": "jconnor",
  • "Password": "superseretPassword.123",
  • "ParticipantIds": [
    ]
}

Response samples

Content type
application/json
{
  • "IdentityId": "3aaa5f64-5717-4562-b3fc-2c963f66af11"
}

Import member data into the tenant database.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "longRunningRequestId": "55cead9f-0c0c-4151-97a5-4b9bddf15493"
}

Exclude the identities from identity hierarchy

Authorizations:
Bearer
path Parameters
identityId
required
string <uuid>

The Internal User ID of an Identity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The list of restricted sub-users

Array
string <uuid>

Responses

Request samples

Content type
[
  • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
]

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

ParticipantManagement

Retrieve details of a participant Deprecated

Retrieve details of a participant

Authorizations:
Bearer
path Parameters
participantId
required
integer <int32>

The ID of the participant

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "uid": "07cc67f4-45d6-494b-adac-09b5cbc7e2b5",
  • "isActive": true,
  • "externalId": "string"
}

Update a participant

Updates a participant

Authorizations:
Bearer
path Parameters
participantId
required
integer <int32>

The ID of the participant

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request body

name
string or null
isActive
boolean
identityInternalUserIds
Array of strings or null <uuid> [ items <uuid > ]

Responses

Request samples

Content type
{
  • "name": "string",
  • "isActive": true,
  • "identityInternalUserIds": [
    ]
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve information on participants

Retrieves information on participants

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "results": [
    ]
}

Create a participant

Creates a participant

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request body

name
string or null
identityInternalUserIds
Array of strings or null <uuid> [ items <uuid > ]
externalId
string or null

Responses

Request samples

Content type
{
  • "name": "string",
  • "identityInternalUserIds": [
    ],
  • "externalId": "string"
}

Response samples

Content type
application/json
{
  • "Id": 1,
  • "UId": "47b846ad-4546-4552-ae42-b5bfa4cfb626"
}

Search participants Deprecated

Searches participants

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The search criteria

page
integer <int32>
pageSize
integer <int32>
sortBy
string or null
sortOrder
string (SortOrder)
Enum: "Ascending" "Descending"
name
string or null
participantIds
Array of integers or null <int32> [ items <int32 > ]
isActive
boolean or null

Responses

Request samples

Content type
{
  • "page": 0,
  • "pageSize": 0,
  • "sortBy": "string",
  • "sortOrder": "Ascending",
  • "name": "string",
  • "participantIds": [
    ],
  • "isActive": true
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "page": 0,
  • "pageSize": 0,
  • "pageCount": 0,
  • "totalCount": 0
}

Associate one or more participants with an application

Associate one or more participants with an application

Authorizations:
Bearer
path Parameters
applicationId
required
string

The application identifier

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request body that contains the collection of participants to be added

participantIds
Array of integers or null <int32> [ items <int32 > ]

Responses

Request samples

Content type
{
  • "participantIds": [
    ]
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

RoleManagement

Role Management API

Delete role

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The ID of the role to delete

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Retrieve information on a specific role

Retrieves information on a specific role

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The ID of the role to update

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "ShortName": "role",
  • "LongName": "role",
  • "RoleKey": "role",
  • "CreatedDate": "2026-03-25T09:56:22.2910705Z",
  • "AllowAllPolicies": false,
  • "AccessPolicies": [
    ]
}

Update role

Updates role information and access policy configuration for the role. Specify AccessPolicyIds only if AllowAllPolicies is set to false. 2 Setting AllowAllPolicies to true will remove the current list of access policies assigned to the role.

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The ID of the role to update

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The parameter DTO

shortName
string or null
longName
string or null
roleKey
string or null
allowAllPolicies
boolean or null
accessPolicyIds
Array of integers or null <int32> [ items <int32 > ]

Responses

Request samples

Content type
{
  • "ShortName": "System-Administrator",
  • "LongName": "System-Administrator",
  • "RoleKey": "admin",
  • "AllowAllPolicies": true,
  • "AccessPolicyIds": [
    ]
}

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Get all roles

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Create role

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The parameter DTO

shortName
string or null
longName
string or null
roleKey
string or null
isMemberAccessExcluded
boolean or null

Set to 1 if members created or moved to this role should not have access to any other member (regardless of hierarchy level) unless manually specified.

Responses

Request samples

Content type
{
  • "ShortName": "System-Administrator",
  • "LongName": "System-Administrator",
  • "RoleKey": "admin",
  • "IsMemberAccessExcluded": true
}

Response samples

Content type
application/json
{
  • "Id": 1,
  • "TenantId": 2,
  • "ShortName": "System-Administrator",
  • "LongName": "System-Administrator",
  • "RoleKey": "admin",
  • "CreatedDate": "2026-03-25T09:56:22.2947334Z"
}

Get role hierarchy by Role ID

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The role ID of Base element of the Role Hierarchy

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Base": {
    },
  • "HierarchyItems": [
    ]
}

Change the hierarchy level of specified role

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The role ID

operation
required
string (RoleHierarchyRankOperation)
Enum: "Up" "Down"

The role hierarchy rank change operation (up or down)

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Set the role hierarchy restrictions

Set the role hierarchy restrictions (forbidden sub-role(s) access) for specified Role ID

Authorizations:
Bearer
path Parameters
roleId
required
integer <int32>

The Role ID

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The list of role IDs to exclude from the hierarchy

Array
integer <int32>

Responses

Request samples

Content type
[
  • 0
]

Response samples

Content type
application/json
{
  • "Code": "BadRequest",
  • "SubCode": "NA",
  • "Message": "The request was not in the required format",
  • "CorrelationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}