curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
API de gestion — Utilisateurs partagés et rôles
Inviter un utilisateur partagé
POST /multi-users/
POST
/
multi-users
/
curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
Les utilisateurs partagés sont les coéquipiers que vous invitez dans votre compte Scanova — la même liste affichée dans le tableau Users du tableau de bord. Cet endpoint vous permet de les lister, de les inviter, de les mettre à jour ou de les supprimer de manière programmatique.
Cet endpoint n’était pas documenté auparavant. Il nécessite une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization — voir la vue d’ensemble de la Management API — ainsi que le propre quota Team du compte pour les utilisateurs partagés. Pour ce que chaque rôle accorde réellement, voir Rôles et permissions ; pour le format des rôles eux-mêmes, voir Rôles (niveaux d’accès).curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
string
requis
Adresse e-mail du nouveau coéquipier. Ne doit pas déjà appartenir à un autre utilisateur Scanova — un doublon renvoie une erreur 400 avec
{"email": ["Email address is already used."]}.string
requis
Nom affiché, jusqu’à 20 caractères.
integer
requis
ID d’un rôle issu de
GET /multi-users/access-levels/ — soit un rôle système par défaut, soit un rôle personnalisé créé par ce compte.array
IDs de tags pour limiter l’accès de cet utilisateur. Nécessite le quota
CUSTOM_TAG/permission par tag du compte — sinon rejeté avec une erreur 403.boolean
défaut:"false"
Restreint les QR codes visibles par cet utilisateur à
tags.boolean
défaut:"true"
Lorsque
enable_tag_permission est vrai, indique si les QR codes sans tag restent visibles.Inviter un coéquipier envoie toujours un e-mail d’invitation — créer l’enregistrement ici a le même effet que de cliquer sur Invite Users dans le tableau Users du tableau de bord. Il n’existe aucun moyen de ne pas envoyer cet e-mail via cet endpoint.
Voir aussi
- Lister les utilisateurs partagés — l’autre opération de ce même endpoint.
- Récupérer un utilisateur partagé — opérez sur l’enregistrement de l’utilisateur partagé après l’avoir invité.
- Mettre à jour un utilisateur partagé — opérez sur l’enregistrement de l’utilisateur partagé après l’avoir invité.
- Supprimer un utilisateur partagé — opérez sur l’enregistrement de l’utilisateur partagé après l’avoir invité.
- Lister les rôles — recherchez ou créez l’ID
access_levelrequis par les appels d’invitation/mise à jour de cet endpoint. - Créer un rôle personnalisé — recherchez ou créez l’ID
access_levelrequis par les appels d’invitation/mise à jour de cet endpoint. - Utilisateurs partagés — le tableau Users du tableau de bord, montrant les mêmes actions d’invitation/désactivation/suppression.
- Rôles et permissions — ce que chaque rôle accorde réellement à un coéquipier.
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
Invitation created — sends an invitation email to the shared user.
Cette page vous a-t-elle été utile ?
⌘I