MonetaryAI / Docs
API ReferenceUsers and roles

Read one company role

Returns effective permission IDs and the current lockVersion for one of the four company defaults. Company permission: `getCompanyRole`. Defaults: ADMIN. Current company role permissions and active membership are checked on every request; signed legacy role claims alone do not authorize this operation.

GET
/api/v1/settings/roles/{code}

Authorization

bearerAuth
headerAuthorizationBearer <token>

Obtained from POST /api/v1/auth/login, on the tenant's own subdomain. Presenting it on another tenant's subdomain is a 403.

Path Parameters

code*string

Response Body

Company role and effective permissions

*/*
  1. response
code?string
defaultPermissions?boolean
id?string
Formatuuid
lockVersion?integer
Formatint32
name?string
permissions?array<string>
curl -X GET 'https://api.monetaryai.uz/api/v1/settings/roles/string'
{  "code": "string",  "defaultPermissions": true,  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "lockVersion": 0,  "name": "string",  "permissions": [    "string"  ]}