Manage Access

Access is managed through the ACL object on the resource.

The ACL object displays the permissions that have been explicitly assigned to the resource. The resource may have additional permissions inherited from its parents. See ACL for more information.

Updating the ACL requires submitting the full array in the request. Below are the steps to add or remove permissions for a space.

Prerequisites

• A space should be created. To know more about creating a space refer here

Add permission for a space

1. Using PATCH API, space permissions can be updated.
   • Assume applicationId1 already provided spaceManager permission during creation. Now, applicationId2 needs to be added as spaceManager for the space.

PATCH {baseUrl}/spaces/{spaceId}

• HEADER:

  • Authorization: Bearer {tid token}

• BODY:

  • acl - Access control list for the space

Add space permission:

{
    "acl": {
        "SpaceManager": [
            "trn:tid:application:<applicationId1>"
            "trn:tid:application:<applicationId2>"
        ]
    }
}

Remove permission for a space

1. Using PATCH API space permissions can be updated.
   • Assume both applicationId1 and applicationId2 provided spaceManager permission during creation. Now, applicationId2 needs to be removed as spaceManager for the space.

PATCH {baseUrl}/spaces/{spaceId}

• HEADER:

  • Authorization: Bearer {tid token}

• BODY:

  • acl - Access control list for the space

Remove space permission:

{
    "acl": {
        "SpaceManager": [
            "trn:tid:application:<applicationId1>"
        ]
    }
}

Similarly, folders and files ACL can also be updated. See here for updating ACLs for folders and files. To know more about update ACL for space refer here.