Create project permission
Creates a new permission assignment for a user or group within the project, granting them specific roles and access levels. Can also be used to request access to the project when the user doesn’t have admin permissions.
Authorization: Requires project admin permissions, unless requestPermission is true.
Parameters: Use requestPermission to indicate the user is requesting access to the resource.
Notification: Use notifyPeople to send email notifications to affected users.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the organization Standard identifier pattern for resource names
^[a-zA-Z0-9_-]+$The unique identifier of the project Standard identifier pattern for resource names
^[a-zA-Z0-9_-]+$Query Parameters
Indicates that the user is requesting access to the resource
Whether to notify people when permissions are granted
Body
Represents a permission assignment for a user or group within a project
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}oruser:{userId} - For groups:
group:{groupName}
^(user:[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}|group:[a-zA-Z0-9._-]+)$The role/permission level granted to the user or group
admin, modeler, viewer Optional message or note about the permission assignment
ISO 8601 timestamp indicating when the permission was created
ISO 8601 timestamp indicating when the permission was last modified
Response
Project permission created successfully
Represents a permission assignment for a user or group within a project
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}oruser:{userId} - For groups:
group:{groupName}
^(user:[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}|group:[a-zA-Z0-9._-]+)$The role/permission level granted to the user or group
admin, modeler, viewer Optional message or note about the permission assignment
ISO 8601 timestamp indicating when the permission was created
ISO 8601 timestamp indicating when the permission was last modified