REST API Reference

Back Next

Updating permissions

You can update an access control list (ACL) to change the access rights that a user or user group has for an object.

PUT request

To update an ACL, send a PUT request using the following URI:

/public/core/v3/objects/<object ID>/permissions/<ACL ID>

Include the following information:

Field	Type	Required	Description
principal	Object	Yes	Whether the permission is defined for a user or user group and the name of the user or user group.
type	String	Yes	Include in principal object. Use one of the following values: USER GROUP
name	String	Yes	Include in principal object. Name of the object.
permissions	Object	Yes	Object permissions to assign to the user or group.
read	Boolean	Yes	Include in permissions object. Whether to allow the user or group to view the object.
delete	Boolean	Yes	Include in permissions object. Whether to allow the user or group to delete the object.
execute	Boolean	Yes	Include in permissions object. Whether to allow the user to run the task.
changePermission	Boolean	Yes	Include in permissions object. Whether to allow the user or group to change the permissions for the object.

PUT response

Returns a success code if successful or an error object if errors occur.

PUT example

To update user permissions for an object, you might send a request similar to the following example:

PUT <baseApiUrl>/public/core/v3/objects/9EcgvBYZ9GGflOYr98GzOH/permissions/4eMlUawPcahhK4eKBmDLsI
Content-Type: application/json
Accept: application/json
INFA-SESSION-ID: <sessionId>
{
    "principal": {
        "type":"USER",
        "name":"scotty@infa.com"
    },
    "permissions" : {
        "read" : true,
        "update" : true,
        "delete" : true,
        "execute" : false,
        "changePermission" : true
    }
}

Rename Saved Search

Table of Contents

REST API Reference

REST API Reference

Updating permissions

Updating permissions

PUT request

PUT response

PUT example