Retrieve Permission details

Returns one permission: the resource it governs, the actions it allows, and the product that declared it.

{id} is the permission’s name — a slug, not a UUID.

Read-only: nothing changes. A permission existing in the catalog says nothing about who HOLDS it; for that, read a role’s permissions or a user’s effective permissions.

Failures:

• 404 — no permission with that name is declared in this deployment.
• 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/permissions/{id}

Retrieve Permission details

cURL

curl --request GET \
  --url https://identity.sandbox.lerian.net/v1/permissions/{id} \
  --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

Permission ID.

Example:

"midaz-accounts-get"

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[]