Create package permission

Creates a new permission assignment for a user, group, or workspace within the package, granting them specific roles and access levels. Can also be used to request access to the package when the user doesn't have admin or modeler permissions.

POST/organizations/{organizationName}/environments/{environmentName}/packages/{packageName}/permissions

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

organizationName*string

The unique identifier of the organization

Match^[a-zA-Z0-9_ -]+$

environmentName*string

The unique identifier of the environment

Match^[a-zA-Z0-9_ -]+$

packageName*string

The unique identifier of the package

Match^[a-zA-Z0-9_ -]+$

Query Parameters

requestPermission?boolean

Indicates that the user is requesting access to the resource

Defaultfalse

notifyPeople?boolean

Whether to notify people when permissions are granted

Defaultfalse

Request Body

application/json

Represents a permission assignment for a user, group, or workspace within a package

userGroupId?UserGroupId

A resource identifier that uniquely identifies either a user or a group within the system. This identifier is used throughout the API for permission management and access control.

Format:

For users: user:{email} or user:{userId}
For groups: group:{groupName}

Match^(user:[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}|group:[a-zA-Z0-9._-]+)$

workspace?IdentifierPattern

Set if this PackagePermission grants Package access to a workspace (not a user)

Match^[a-zA-Z0-9_ -]+$

permission?string

The role/permission level granted to the user, group, or workspace

Value in

"admin"
"modeler"
"viewer"

inheritedPermission?string

The permission level inherited from parent environment or organization

Value in

"admin"
"modeler"
"viewer"

message?string

Optional message or note about the permission assignment

createdAt?string

ISO 8601 timestamp indicating when the permission was created

Formatdate-time

updatedAt?string

ISO 8601 timestamp indicating when the permission was last modified

Formatdate-time

Response Body

`application/json`

curl --request POST \  --url 'https://example.com/organizations/string/environments/string/packages/string/permissions' \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{}'

{  "userGroupId": "string",  "workspace": "string",  "permission": "admin",  "inheritedPermission": "admin",  "message": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Create package permission

Authorization

Path Parameters

Query Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`