Update the repository item permissions

patch/repository/items/{itemId}/permissions

Update the repository item permissions.

Request Samples

1

Response Samples

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

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.

removals
array [Principal Identity]
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
200OK

The request succeeded and the specified repository item permissions have been updated.

Schema
400Bad Request

Bad Request