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

  • Org admin (Environment 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.

Example: control-plane-name.snaplogic.com

Where control-plane-name is the control plane you are using. For example,
  • elastic
  • uat
  • emea
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

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
  • 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.