Check user permission

GET

/api/v1/rbac/check/permission/{permission}

const url = 'https://localhost:8080/api/v1/rbac/check/permission/example';
const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://localhost:8080/api/v1/rbac/check/permission/example \
  --header 'Authorization: <Authorization>'

Report whether the authenticated user holds the given permission and which role scope satisfied it

Authorizations

BearerAuth
ApiKeyAuth

Parameters

Path Parameters

permission

required

string

Permission name

Responses

200

Permission check result

application/json

object

context

string

hasPermission

boolean

permission

string

projectId

string

userId

string

Example

{
  "context": "organization",
  "hasPermission": true,
  "permission": "manage_org_settings",
  "projectId": "1",
  "userId": "550e8400-e29b-41d4-a716-446655440001"
}

401

Unauthorized - Authentication required

application/json

object

error

string

error_description

string

Example

{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}