Grant a user or group access to a project or project space

POST /assetapi/acl/{project_or_space_path}


This API grants a user or group access to the specified project or project space.

If you call this API on a project space, the change to the user or group access is also applied to the project space’s corresponding shared folder.


  • Environment (Org) admin permissions


 POST https://{controlplane_path}/api/1/rest/public/assetapi/acl/{project_or_space_path}

Path Parameters

Key Description
controlplane_path Required. The path to the SnapLogic control plane.


For other control planes, substitute the subdomain name for elastic. For example:
project_or_space_path Required. The path to the SnapLogic project or project space.

This path is normalized to its respective project space path, whether /shared or another project folder exists at the end of the path. Therefore, the provided permissions are updated for this path’s project space and its shared folder only.

  • Project: /{env_org}/{project_space}/{project_name}
  • Project space: /{env_org}/{project_space}
Important: The path comparison is case-sensitive.

Query Parameters


Request Header

Specify Basic for authorization and application/json for content type.

Authorization: Basic {your_encoded_security_credentials}
Content-Type: application/json

Request Body

  "grant_type" : "...",
  "grantee" : "...",
  "permission_list" : [ ... ],
  "inherit" : true
Key Type Description
grant_type string The type of the grantee.
Valid values:
  • USER
grantee string The user or group to whom to grant access.
permission_list array An array containing one or more of the following permissions:
  • "R" – read
  • "W" – write
  • "X" – execute

Learn more: Permissions in Manager and in APIs

inherit Boolean If true, the permissions also apply to all assets in the specified project or project space.


Status code only.