Update package permission

Updates the permission assignment for a user, group, or workspace within the package, modifying their role and access level.

PATCH/organizations/{organizationName}/environments/{environmentName}/packages/{packageName}/permissions/{userGroupId}

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_ -]+$

userGroupId*string

The resource identifier of the User or Group Permissions for this package.

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

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 PATCH \  --url 'https://example.com/organizations/string/environments/string/packages/string/permissions/string' \  --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"}

Update package permission

Authorization

Path 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`