Create new project or project space

POST /assetapi/project/{project_or_space_path}

Overview

This API creates a new project or project space at the specified path with the specified permissions.

To assign admin privileges to other users, use one of the following APIs to add them to the admins group:
  • PATCH /groups/{env_org}/{groupname}
  • PUT /groups/{env_org}/{groupname}

Prerequisites

  • Org admin (Environment admin) permissions or Full Access permissions to the project or project space

Request

 POST https://{controlplane_path}/api/1/rest/public/assetapi/project/{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.
Format:
  • Project: /{env_org}/{project_space}/{project_name}
  • Project space: /{env_org}/{project_space}
Important: The path comparison is case-sensitive.
Note: The names of assets, projects, or project spaces are limited to UTF-8 alphanumeric characters and these special characters: !"$%&'()*+,-.:;<=>@[]^_`{|}~.

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

 {
  "permissions":[
    {
      "perms": [ ... ],
      "inherit": true,
      "subject_type": "...",
      "subject": "..."
    }
  ]
}
Key Type Description
perms 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.
subject_type string The type of the subject.
Valid values:
  • USER
  • GROUP
subject string The user or group who can access the new project or project space.

Response

Status code only.