Create role

POST

/iam/v1/roles

Create a new role

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Created

application/json

Role created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠422Unprocessable Entity

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/iam/v1/roles' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Administrator",
    "type": "admin",
    "description": "Full system administrator role"
}'

Response Example

201 - Exemplo 1

{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Administrator",
    "type": "admin",
    "description": "Full system administrator role"
}

Modificado em 2025-09-25 18:20:35