Create New Project or Project Space

This page is no longer maintained (Mar 29, 2023). For the most current information, go to https://docs.snaplogic.com/public-apis/post-assetapi-project-path.html.

 

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/{org}/{groupname}

  • PUT /groups/{org}/{groupname}

Prerequisites

  • Org Admin permissions or Full Access permissions to the project or project space

Request

Path Parameters

Key

Description

Key

Description

pod_path

Required. The path to your SnapLogic pod.

Example: elastic.snaplogic.com

project_or_space_path

Required. The path to the SnapLogic project or project space.

Format:

  • Project: /{org}/{project_space}/{project_name}

  • Project space: /{org}/{project_space}

The path comparison is case-sensitive.

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.

Request Body

{ "permissions":[ { "perms": [ ... ], "inherit": ..., "subject_type": "...", "subject": "..." } ] }

Key

Type

Description

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.