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

Basic authentication

In the request header, specify Basic for authorization, add your credentials (Login and password of your SnapLogic user or service account), and specify application/json for content type. For more details on accounts refer to Manage accounts.


Authorization: Basic {base64_encoded <email>:<password>}
Content-Type: application/json

Example of Basic authenthication using Postman

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.