Skip to main content
PATCH
/
library
/
v1beta1
/
{libId}
/
roles
/
{roleId}
cURL
curl --request PATCH \
  --url https://aodocs.altirnao.com/api/library/v1beta1/{libId}/roles/{roleId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aclEntries": [
    {
      "classId": "<string>",
      "className": "<string>",
      "description": "<string>",
      "displayName": "<string>",
      "displayName_i18n": "<string>",
      "thumbnailPictureUrl": "<string>",
      "type": "USER",
      "value": "<string>"
    }
  ],
  "appMetadata": {},
  "description": "<string>",
  "id": "<string>",
  "kind": "<string>",
  "name": "<string>",
  "name_i18n": "<string>",
  "privileges": {},
  "type": "LIBRARY"
}
'
{
  "aclEntries": [
    {
      "classId": "<string>",
      "className": "<string>",
      "description": "<string>",
      "displayName": "<string>",
      "displayName_i18n": "<string>",
      "thumbnailPictureUrl": "<string>",
      "type": "USER",
      "value": "<string>"
    }
  ],
  "appMetadata": {},
  "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.

Path Parameters

​
libId
string
required

The ID of the library

​
roleId
string
required

The ID of the role

Query Parameters

​
domain
string

The G Suite domain

​
securityCode
string

The security code

Body

application/json
​
aclEntries
object[]

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

​
appMetadata
object

App Metadata let developers associate metadata with various configuration entities. The metadata is isolated within app namespaces in order to prevent one application from interfering with another's metadata.

​
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 ApiLibraryRole response

​
aclEntries
object[]

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

​
appMetadata
object

App Metadata let developers associate metadata with various configuration entities. The metadata is isolated within app namespaces in order to prevent one application from interfering with another's metadata.

​
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