curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
API de gestion — Utilisateurs partagés et rôles
Créer un rôle personnalisé
POST /multi-users/access-levels/
POST
/
multi-users
/
access-levels
/
curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
Chaque utilisateur partagé se voit attribuer un rôle — le tableau de bord de Scanova appelle cela en interne des « access levels » (niveaux d’accès), et ce même terme apparaît tout au long de cet endpoint. Utilisez cet endpoint pour consulter les rôles disponibles avant d’inviter un coéquipier via
POST /multi-users/, ou pour créer un rôle personnalisé depuis vos propres systèmes.
Cet endpoint n’était pas documenté auparavant. Il nécessite une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) — voir la vue d’ensemble de la Management API. Pour ce que chaque rôle accorde réellement à un coéquipier, voir le guide destiné aux utilisateurs Rôles et permissions — cette page ne documente que le format d’échange (wire format).Créer des rôles personnalisés nécessite un quota dédié sur le plan du compte (la même restriction qui masque l’onglet Roles du tableau de bord sur les plans non pris en charge — voir Les rôles personnalisés sont limités par le plan). Une erreur 403 ici signifie que le plan ne l’inclut pas.
curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
string
requis
Nom du rôle. Doit être unique parmi les rôles de ce compte — un doublon renvoie une erreur 400 avec
{"name": ["Can not create another user role with the same name."]}.array
requis
IDs de permissions à accorder, issus des valeurs
permissions[].id de la réponse de liste ci-dessus.Il n’existe pas d’endpoint groupé « lister toutes les permissions disponibles indépendamment d’un rôle » sur la Management API — pour découvrir les IDs de permissions, consultez-les dans le tableau
permissions d’un rôle existant (chaque compte dispose au moins des 6 rôles système à consulter).Voir aussi
- Lister les rôles — l’autre opération de ce même endpoint.
- Inviter un utilisateur partagé — attribuez un ID de rôle de cette liste lors de l’invitation ou de la mise à jour d’un coéquipier.
- Mettre à jour un utilisateur partagé — attribuez un ID de rôle de cette liste lors de l’invitation ou de la mise à jour d’un coéquipier.
- Rôles et permissions — l’explication destinée aux utilisateurs de ce que chaque rôle accorde, y compris la restriction de plan sur les rôles personnalisés.
- Utilisateurs partagés — le tableau Users du tableau de bord où ces rôles sont attribués via l’interface.
Autorisations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. 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. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Corps
application/json
Réponse
201 - application/json
Custom role created. Requires the account's custom-roles plan quota.
Cette page vous a-t-elle été utile ?
⌘I