List the Permissions of a Role

Returns every permission the role carries, as a plain array — this listing is NOT paginated.

A role is a named bundle of permissions; this is what is inside the bundle. Called to open a role’s detail screen, and before adding or removing entries so the form starts from the current state.

Read-only: nothing changes. It answers “what does this role allow?”, not “who holds it?” — for the holders, list users or groups filtered by this role.

Failures:

• 404 — no such role in your organization.
• 503 IDE-0066 — the identity provider is unavailable (unreachable, too slow to answer, or failing). Nothing about the request was wrong; retry it later.

GET /v1/roles/{id}/permissions

List the Permissions of a Role

cURL

curl --request GET \
  --url https://identity.sandbox.lerian.net/v1/roles/{id}/permissions \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "actions": [
      "<string>"
    ],
    "effect": "allow",
    "groups": [
      "<string>"
    ],
    "id": "midaz-editor-permission",
    "isEnabled": true,
    "name": "Midaz Editor Permission",
    "resources": [
      "<string>"
    ],
    "roles": [
      "<string>"
    ],
    "users": [
      "<string>"
    ]
  }
]

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Path Parameters

id · string · required

Role ID.

Example:

"midaz-editor"

Response

200

application/json

OK

actions · string[]

effect · string

Example:

"allow"

groups · string[]

id · string

Example:

"midaz-editor-permission"

isEnabled · boolean

Example:

true

name · string

Example:

"Midaz Editor Permission"

resources · string[]

roles · string[]

users · string[]