curl "https://api.scanova.io/multi-users/access-levels/3/" \
-H "Authorization: YOUR_API_KEY"
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true }
],
"is_custom": false
}
Shared Users & Roles
Retrieve a role
GET /multi-users/access-levels//
GET
/
multi-users
/
access-levels
/
{pk}
/
curl "https://api.scanova.io/multi-users/access-levels/3/" \
-H "Authorization: YOUR_API_KEY"
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true }
],
"is_custom": false
}
Retrieves a single role (access level) on
Visible: the account’s own custom roles, plus every system role (
api.scanova.io, authenticated with your raw API key.
GET https://api.scanova.io/multi-users/access-levels/{pk}/
Authorization: YOUR_API_KEY
integer
required
The role’s
id, from List roles.curl "https://api.scanova.io/multi-users/access-levels/3/" \
-H "Authorization: YOUR_API_KEY"
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true }
],
"is_custom": false
}
is_custom: false) — those are shared across all accounts, not just this one’s.
Related
- List roles — find a role
id. - Update a custom role — modify this role, if it’s one of the account’s own.
- Delete a custom role — remove this role, if it’s one of the account’s own.
- API overview — the auth scheme and quota rules that apply to this endpoint.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Path Parameters
Response
One role, with its permission set. Visible: the account's own custom roles, plus every system role.
Was this page helpful?