Skip to main content
POST
/
domain
/
v1beta1
/
roles
cURL
curl --request POST \
  --url https://aodocs.altirnao.com/api/domain/v1beta1/roles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aclEntries": [
    {
      "addedBy": "<string>",
      "addedTime": "2023-11-07T05:31:56Z",
      "classId": "<string>",
      "className": "<string>",
      "description": "<string>",
      "displayName": "<string>",
      "displayName_i18n": "<string>",
      "thumbnailPictureUrl": "<string>",
      "type": "USER",
      "value": "<string>"
    }
  ],
  "description": "<string>",
  "id": "<string>",
  "kind": "<string>",
  "name": "<string>",
  "name_i18n": "<string>",
  "privileges": {},
  "type": "LIBRARY"
}
'
{
  "aclEntries": [
    {
      "addedBy": "<string>",
      "addedTime": "2023-11-07T05:31:56Z",
      "classId": "<string>",
      "className": "<string>",
      "description": "<string>",
      "displayName": "<string>",
      "displayName_i18n": "<string>",
      "thumbnailPictureUrl": "<string>",
      "type": "USER",
      "value": "<string>"
    }
  ],
  "description": "<string>",
  "id": "<string>",
  "kind": "<string>",
  "name": "<string>",
  "name_i18n": "<string>",
  "privileges": {},
  "type": "LIBRARY"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
domain
string

The domain

​
securityCode
string

The security code

Body

application/json
​
aclEntries
object[]

The list of user/group/field members of the role

​
description
string

The description of the role

​
id
string

The ID of the role (read-only field)

​
kind
string
​
name
string

The name of the role

​
name_i18n
string

The internationalized name of the role (read-only field)

​
privileges
object

The list of privileges belonging to predefined role types (read-only field)

​
type
enum<string>

The type of role in the library: LIBRARY (administrators, contributors, readers), DOCUMENT (document creator, version creator), CUSTOM for any role created manually (including predefined roles) (read-only field)

Available options:
LIBRARY,
DOCUMENT,
PREDEFINED,
CUSTOM

Response

200 - application/json

A ApiDomainRole response

​
aclEntries
object[]

The list of user/group/field members of the role

​
description
string

The description of the role

​
id
string

The ID of the role (read-only field)

​
kind
string
​
name
string

The name of the role

​
name_i18n
string

The internationalized name of the role (read-only field)

​
privileges
object

The list of privileges belonging to predefined role types (read-only field)

​
type
enum<string>

The type of role in the library: LIBRARY (administrators, contributors, readers), DOCUMENT (document creator, version creator), CUSTOM for any role created manually (including predefined roles) (read-only field)

Available options:
LIBRARY,
DOCUMENT,
PREDEFINED,
CUSTOM