Skip to main content
PUT
Update a shared user's role/access
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).
integer
requis
L’ID de l’enregistrement d’utilisateur partagé issu de la réponse de liste ci-dessus.
PUT renvoie la même structure que la réponse d’invitation ci-dessus.
email et name sont réservés à la création — les envoyer dans un corps de PUT est silencieusement ignoré plutôt que de générer une erreur, car l’identité d’un utilisateur partagé ne peut pas être modifiée après l’envoi de l’invitation. Pour mettre à jour le rôle, la portée des tags ou l’état actif, n’utilisez que les champs que vous souhaitez modifier.

Voir aussi

Autorisations

Authorization
string
header
requis

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.

Paramètres de chemin

pk
integer
requis

Corps

application/json
access_level
integer
is_active
boolean
tags
integer[]
enable_tag_permission
boolean
include_untagged
boolean

Réponse

200

Shared user updated.