Docs Identité et accès Utilisateurs et équipes Référence des utilisateurs, invitations et équipes Référence des utilisateurs, invitations et équipes Champs, statuts et limites des utilisateurs, des invitations et des équipes, et opérations de l'API publique avec leurs droits.
Référence Développeur Administrateur
Mis à jour le 2 novembre 2026
Cette page décrit les objets manipulés dans cette section. Les paramètres et codes de réponse de chaque endpoint sont détaillés dans la référence API des utilisateurs , des invitations et des équipes .
Utilisateur#
Champ Type Contraintes Description idUUID propre à la fiche Identifiant interne, utilisé pour l'ajout à une équipe widchaîne 6 caractères, propre à la fiche Identifiant court, utilisé dans les URL emailchaîne 255 caractères, unique par client et par environnement , en minuscules Adresse de connexion, non modifiable envTypeénumération dev, staging, prodEnvironnement de la fiche : celui de l'appelant qui l'a créée ou de l'invitation acceptée. Non modifiable keycloakIdchaîne Compte Keycloak de la fiche, sur l'instance de son environnement firstName, lastNamechaîne 100 caractères chacun Prénom, nom adminLevelénumération PARTNER_ADMIN, APP_ADMIN, NETWORK_ADMIN, CUSTOMER_ADMIN, USER, NONENiveau d'administration ; NONE par défaut isActivebooléen true par défautActif ou désactivé customerIdUUID obligatoire Client de l'utilisateur lastLoginAtdate Dernière connexion
Une même adresse peut avoir une fiche par environnement chez un client : trois fiches indépendantes, chacune avec son id et son wid. Mot de passe : 8 caractères au moins. Lien de l'e-mail Keycloak envoyé à la création : 24 heures.
Invitation#
Champ Type Contraintes Description idUUID Identifiant invitedEmailchaîne adresse valide Personne invitée invitedFirstName, invitedLastNamechaîne 100 caractères chacun Repris dans l'e-mail customerIdUUID ou WID obligatoire Client à rejoindre. customerWid est déprécié profileWidWID obligatoire Profil attribué à l'acceptation ; profileId (UUID) reste accepté envTypeénumération dev, staging, prod ; lecture seuleEnvironnement de l'invitation : celui de l'inviteur. Fourni dans la requête, il est refusé (400) teamAssignmentstableau [{ teamId | teamWid, teamLevel }]Équipes rejointes à l'acceptation languagechaîne fr (défaut), en, es, de, nl, it, ptLangue de l'e-mail statusénumération voir le tableau des statuts Statut expiresAtdate envoi + durée de validité Échéance
Le jeton d'une invitation fait 64 caractères hexadécimaux en minuscules.
Statuts d'une invitation#
Statut Signification Relance Annulation PENDINGEn attente oui oui ACCEPTEDAcceptée, compte créé non (400) non (400) EXPIREDÉchéance passée oui oui CANCELLEDAnnulée oui sans effet
Réglages d'invitation de l'application#
Champ Libellé de la console Valeurs Par défaut invitationsEnabledActiver les invitations booléen trueinvitationVerifyEmailVérification email obligatoire booléen trueinvitationNotifyInviterNotification à l'inviteur booléen falseacceptInvitationUrlURL d'acceptation des invitations URL http(s), 500 caractères, marqueur {token} vide invitationExpiryDays(API) 1 à 365 jours 10 invitationPerUserLimit(API) 1 à 10 000 par auteur sur 30 jours, ou null null
Équipe#
Champ Type Contraintes Description widchaîne 6 caractères Identifiant court customerIdUUID Client de l'équipe namechaîne 100 caractères, obligatoire Nom descriptionchaîne Description
Membre d'une équipe#
Champ Valeurs Description teamLevelADMIN, MANAGER, MEMBER (défaut), CONTRIBUTOR, VIEWER, NONENiveau dans l'équipe appRights0 à 52 lettres A-Z, a-z Droits d'équipe, interprétés par votre application
Import CSV#
Propriété Valeur Colonnes email (obligatoire), firstName, lastName, adminLevelSéparateur virgule Taille 2 Mo, 500 lignes de données Niveau par défaut NONE ; seuls CUSTOMER_ADMIN, USER et NONE sont acceptésEnvironnement Celui de l'appelant ; import refusé s'il ne peut pas être déduit Coût opération de crédits IMPORT_USERS, débitée au lancement
Opérations de l'API publique#
URL de base : https://api.wakastart.app/api.
Opération Méthode et chemin Accès Lister les utilisateurs GET /config/usersAdministrateur client + users.read Rechercher par e-mail GET /config/users/search?email=Administrateur client + users.read Consulter un utilisateur GET /config/users/{wid}Administrateur client + users.read Statistiques GET /config/users/statsAdministrateur client + users.stats Créer un utilisateur POST /config/usersAdministrateur client + users.create Modifier un utilisateur PUT /config/users/{wid}Administrateur client + users.update Désactiver, réactiver PATCH /config/users/{wid}/disable, /enableAdministrateur client + users.disable Supprimer un utilisateur DELETE /config/users/{wid}Administrateur client + users.delete Modèle CSV GET /import/users/templateAdministrateur client + users.read Importer un CSV POST /import/users?customerId={uuid}Administrateur client + users.import + crédits Inviter POST /invitationsAdministrateur client + invitations.create Lister les invitations GET /invitations/sent, GET /invitations/by-customer/{customerId}invitations.readConsulter une invitation GET /invitations/{id}invitations.readRelancer POST /invitations/{id}/resendinvitations.createAnnuler DELETE /invitations/{id}invitations.revokeVérifier un lien GET /invitations/verify/{token}public Accepter POST /invitations/accept/{token}public Équipes GET, POST /config/teams ; GET, PUT, DELETE /config/teams/{wid}Administrateur client + teams.read, teams.create, teams.update, teams.delete Membres d'une équipe GET, POST /config/teams/{wid}/members ; PATCH /config/teams/{teamWid}/members/{userWid}/role ; DELETE /config/teams/{teamWid}/members/{userWid}Administrateur client + teams.read ou teams.members.add
Toutes ces opérations portent sur l'environnement de l'appelant (session ou clé API) ; les paramètres env, envType et envs sont refusés en 400.
Limites de débit : 10 requêtes par seconde, 100 par minute et 1 000 par heure par adresse IP ; 60 par seconde, 600 par minute et 5 000 par heure pour la vérification et l'acceptation d'une invitation.