v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB
Roles

Add permissions to role

Adds one or more permissions to the specified role while preserving existing permission assignments. Use this endpoint to grant additional capabilities to a role without affecting its current permission set. Provide the role name as a path parameter and a list of permission names in the request body. The system will validate that all specified permissions exist in the environment and add them to the role. Existing permission assignments remain unchanged, making this operation safe for incremental permission management. This is useful for gradually expanding role capabilities or adding new permissions as your system evolves. Returns the updated list of all permissions now assigned to the role.

post/api/v1/roles/{role_name}/permissions

Path parameters

role_namestring required

Name of the role

Request body

permission_namesstring[]

List of permission names to add to the role

Response

Permissions added to role successfully. Returns the complete list of all permissions now assigned to the role, including both existing and newly added permissions.

Example response

{
  "permissions": [
    {
      "is_scalekit_permission": true
    }
  ]
}