Update the repository item permissions

patch/repository/items/{itemId}/permissions
Internal-Use Only

Update the repository item permissions.

Request Samples

1

Response Samples

1{
2 "version": 1,
3 "itemId": "cac68a83-2f9b-4e45-859f-1163581edf1e",
4 "itemTypeId": "businessunit",
5 "current": true,
6 "owner": {
7 "version": 1,
8 "id": "sastest1",
9 "typeId": "user",
10 "name": "SAS Test User 1",
11 "displayName": "SAS Test User 1 (sastest1)"
12 },
13 "entries": [
14 {
15 "version": 1,
16 "principal": {
17 "version": 1,
18 "id": "sastest1",
19 "typeId": "aclOwner",
20 "name": "Owner",
21 "displayName": "Owner"
22 },
23 "readPermission": "ALLOW",
24 "writePermission": "ALLOW",
25 "deletePermission": "ALLOW",
26 "adminPermission": "ALLOW"
27 },
28 {
29 "version": 1,
30 "principal": {
31 "version": 1,
32 "id": "cac68a83-2f9b-4e45-859f-1163581edf1e",
33 "typeId": "aclMembers",
34 "name": "Members",
35 "displayName": "Members"
36 },
37 "readPermission": "ALLOW",
38 "writePermission": "UNSET",
39 "deletePermission": "UNSET",
40 "adminPermission": "UNSET"
41 },
42 {
43 "version": 1,
44 "principal": {
45 "version": 1,
46 "id": "sastest2",
47 "typeId": "user",
48 "name": "SAS Test User 2",
49 "displayName": "SAS Test User 2 (sastest2)"
50 },
51 "readPermission": "ALLOW",
52 "writePermission": "UNSET",
53 "deletePermission": "UNSET",
54 "adminPermission": "UNSET"
55 },
56 {
57 "version": 1,
58 "principal": {
59 "version": 1,
60 "id": "01c4b251-639e-4500-a575-6c680c219b9a",
61 "typeId": "group",
62 "name": "TestGroup",
63 "displayName": "TestGroup (Business Unit)",
64 "contextId": "cac68a83-2f9b-4e45-859f-1163581edf1e",
65 "contextTypeId": "businessunit"
66 },
67 "readPermission": "ALLOW",
68 "writePermission": "ALLOW",
69 "deletePermission": "ALLOW",
70 "adminPermission": "UNSET"
71 }
72 ]
73}

Path Parameters

NameTypeRequiredDescription
itemId
string
true

The unique identifier for the repository item.

Query Parameters

NameTypeRequiredDescription
current
boolean
false

True (default) if updating current permissions; otherwise false.

Request Body

The specification for permission list updates, additions and removals.

The specification for updating permissions on a single repository item. This applies only when the 'action' request parameter is 'UPDATE'.

NameTypeRequiredDescription
version
number
false

The version of the representation. This is version 1.

Example:
1
removals
$ref(#/components/schemas/permissionsEntryPropagation/properties/principal)[]
false

The set of principals to remove from the permissions list.

updates
array [Permissions Entry Update]
false

The set of existing permissions entries to update in the permissions list.

additions
array [Permissions Entry Update]
false

The set of permission entries to add to the permissions list.

Responses

StatusMeaningDescription
200OKThe request succeeded and the specified repository item permissions have been updated.Schema
400Bad RequestBad Request