Search roles

POST

/iam/v1/roles/search

Search for roles by term with pagination

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

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

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200OK

application/json

Search results

Body

🟠400Bad Request

🟠401Unauthorized

🟠422Unprocessable Entity

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/iam/v1/roles/search' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "term": "admin",
    "page": 1,
    "limit": 10
}'

Response Example

200 - Exemplo 1

{
    "data": [
        {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "name": "Administrator",
            "type": "admin",
            "description": "Full system administrator role"
        }
    ],
    "meta": {
        "total": 150,
        "page": 1,
        "records": 10,
        "pages": 15
    }
}

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