accessmanagement - user roles

Creates a new user role.

This endpoint creates a new user role, allowing users to define custom permissions and manage access effectively.</br></br>Key features include:</br></br>- Clear success messaging: Returns a 200 success code with a confirmation message indicating the successful completion of the requested action.</br>- Comprehensive error handling: Returns a 400 error code with a clear description when requests fail.</br>- Seamless user role creation: Facilitates the creation of a user role in-line with the appropriate schema, ensuring smooth and efficient organization.

post/accessmanagement/userroles

Request

Request body

namestring
descriptionstring

Example request

{
  "name": "Custom role",
  "description": "Custom role description",
  "permissions": [
    {
      "typeId": 1,
      "actionId": 3,
      "deny": true,
      "status": "IMPLICIT_DENY"
    }
  ]
}

Response

User role created successfully.

idinteger
namestring
descriptionstring

Example response

{
  "id": 1,
  "name": "Custom Role",
  "description": "Custom Role description"
}

Changes

No recorded changes to this operation across all 1 revision of this API.