v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB
Users

Validate a role

Enterprise feature

Check if the role matches schema and has a unique name

post/api/admin/roles/validate

Request body

OR

Example request

{
  "name": "external-contributors",
  "description": "Users with external-contributors role have limited access to most features in Unleash",
  "type": "root-custom",
  "permissions": [
    {
      "name": "CREATE_PROJECT",
      "environment": "development"
    }
  ]
}

Response

This response has no body.