Add an Assigned Access permission

POST {{baseUrl}}/v2/nodes/:id/permissions/custom?expand=aliquip aute&metadata=irure labore Duis dolor ea&suppress_response_codes=irure labore Duis dolor ea

Add an Assigned Access permission on the node.

NOTE: This can only be done using the 'body' parameter (see the [IMPLEMENTATION NOTES]).

Examples:

Add permissions for the user/group 15234, with 'see' and 'see contents' permissions:
body = {permissions:[see,see_contents],right_id:15234}

Add permissions for the user/group 15234, with 'see' and 'see contents' permissions and apply to 'This Item':
body = {permissions:[see,see_contents],right_id:15234,apply_to:0}

Add permissions for the user/group 15234, with 'see' and 'see contents' permissions and apply to 'This Item and Sub-Items' where the Sub-Items are Task List and Channel:
body = {permissions:[see,see_contents],right_id:15234,apply_to:2,include_sub_types:[204,207]}

Request Params

KeyDatatypeRequiredDescription
expandstringResolve individual fields (e.g. expand=properties{id,parent_id}&expand=versions{file_name}) or entire sections (eg. expand=properties) that contain known identifiers (nodes, members, etc.).
metadatastringReturns metadata (data type, field length, min/max values, etc.) about data. This is an empty parameter, thus no value is required (e.g. ?metadata).
suppress_response_codesstringForces the server to always return a HTTP Response of '200 OK'. The data returned from the call will have an additional integer feature named 'statusCode', which will contain the actual status code (the 'statusCode' feature will be added regardless of whether the REST API call was successful or not).<br><br>NOTE: This parameter does not require a value, so it should be specified as <ul><li><b>[Query String]:</b><code>?suppress_response_codes</code></li><li><b>[Form Body (where the value is an empty string)]</b>: <code>suppress_response_codes = </code></li></ul>

Request Body

[{"name"=>"permissions", "value"=>"add_major_version", "datatype"=>"string"}, {"name"=>"permissions", "value"=>"reserve", "datatype"=>"string"}, {"name"=>"right_id", "value"=>"35623330", "datatype"=>"number"}, {"name"=>"apply_to", "value"=>"2", "datatype"=>"number"}, {"name"=>"include_sub_types", "value"=>"veniam cu", "datatype"=>"string"}, {"name"=>"include_sub_types", "value"=>"reprehenderit proident nulla adipisicing", "datatype"=>"string"}]

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;results&quot;:[{&quot;data&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]},{&quot;data&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]}],&quot;links&quot;:[{&quot;data&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]},{&quot;data&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]}]}