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

POST /assetapi/acl/{project_or_space_path}

Overview

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.

Prerequisites

  • Environment (Org) admin permissions

Request

 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: elastic.snaplogic.com
For the UAT or EMEA control plane, substitute the name for elastic. For example:
  • uat.snaplogic.com
  • emea.snaplogic.com
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.

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

Query parameters

None.

Request header

In the request header, specify Basic for authorization, add your credentials, and specify application/json for content type:


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

Request body

{
  "grant_type": "USER",
  "grantee": "[email protected]",
  "permission_list": [
    "R",
    "W",
    "X"
  ],
  "inherit": false
}
Key Type Description
grant_type string The type of the grantee.
Valid values:
  • USER
  • GROUP
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.

Response

Status code only.