Create a custom role

POST

Create a custom role that you can assign to users, Teams, and API tokens.

Path parameters

organizationIdstringRequired

The ID of the Organization where you want to create the custom role.

Request

This endpoint expects an object.
namestringRequired

The role’s name.

permissionslist of stringsRequired

The permissions included in the role.

scopeType"DEPLOYMENT"Required

The scope of the role.

descriptionstringOptional

The role’s description.

restrictedWorkspaceIdslist of stringsOptional

The IDs of the Workspaces that the role is restricted to.

Response

OK

createdAtstring

The time the role was created.

createdByobject
idstring

The role’s ID.

namestring

The role’s name.

permissionslist of strings

The role’s permissions.

restrictedWorkspaceIdslist of strings

The IDs of Workspaces that the role is restricted to.

scopeTypeenum
Allowed values: DEPLOYMENTWORKSPACEORGANIZATION

The role’s scope.

updatedAtstring

The time the role was last updated.

updatedByobject
descriptionstringOptional

The role’s description.

Built with