SSO - Création et mise à jour d'un utilisateur via API
Pour pouvoir créer un utilisateur Powerslide via API, il faut au préalable avoir récupéré un token avec des droits administrateurs, comme vu au chapitre SSO - Récupération de tokens utilisateurs.
En disposant du token administrateur $TOKEN, vous pouvez créer un utilisateur en faisant appel à l'API suivante avec les paramètres :
- $EMAIL : l'email de l'utilisateur
- $UUID : un identifiant de type uuidv4 pour cet utilisateur
- $ROLENAME : le role de l'utilisateur : "Tenant Administrator", "Viewer" ou "Designer"
- $SENDEMAIL : booléan (true/false) pour déterminer si un email doit être envoyé à l'utilisateur pour lui notifier de la création du compte
post
https://app.powerslide.io/graphql
/
Création d'un utilisateur Powerslide
En disposant du token administrateur $TOKEN, vous pouvez modifier un utilisateur en faisant appel à l'API GRAPHQL suivante avec les paramètres :
- $ACCOUNTID : l'identifiant de l'utilisateur (au format uuidv4)
- optionnel : $VERSION : la version actuelle de l'utilisateur, pour vérifier que l'on modifie bien la dernière version. Ce paramètre est à omettre dans le cas où l'on veut mettre à jour l'utilisateur sans contrôle de version.
- $NEWEMAIL: optionnel, le nouvel email de l'utilisateur
- $ATTRIBUTES: optionnel, un tableau d'attributs utilisateurs pour le filtrage des données dans les slides. Par exemple : [{"key":"user", "value":"U01"}]
- $FIRSTNAME : optionnel : le nouveau prénom de l'utilisateur
- $LASTNAME : optionnel : le nouveau nom de l'utilisateur
- $JOBTITLE : optionnel : le nouveau titre d'emploi de l'utilisateur
- $LANGUAGE : optionnel, le nouveau langage de l'utilisateur (fr ou en)
- $ROLENAME : optionnel, le nouveau role de l'utilisateur, typiquement "Viewer" ou "Designer"
- $GROUPID : optionnel, l'identifiant du groupe de l'utilisateur, qui lui permettra d'avoir accès en lecture aux slides
post
https://app.powerslide.io/graphql
/
Modification d'un utilisateur
En disposant du token administrateur $TOKEN, vous pouvez supprimer un utilisateur en faisant appel à l'API GRAPHQL suivante avec les paramètres :
- $ACCOUNTID : identifiant de l'utilisateur à supprimer (au format uuidv4)
post
https://app.powerslide.io/graphql
/
Suppression d'un utilisateur Powerslide
En disposant du token administrateur $TOKEN, vous pouvez lister les utilisateurs en faisant appel à l'API GRAPHQL suivante :
post
https://app.powerslide.io/graphql
/
Listing des utilisateurs Powerslide
Ce listing sera utile pour récupérer les IDs et versions des utilisateurs existants pour pouvoir les modifier.