Équipes
Créer des équipes dans un client, y ajouter des membres et régler leur niveau et leurs droits d'équipe par l'API publique.
Une équipe regroupe des utilisateurs d'un même client. Chaque membre y a un niveau d'équipe et, en option, des droits d'équipe codés par des lettres que votre application interprète. Votre serveur peut ensuite contrôler l'appartenance d'un utilisateur avec POST /api/token/check/team.
Accès commun : appelant de niveau Administrateur client (CUSTOMER_ADMIN) au minimum, avec le droit applicatif indiqué. Les modifications exigent en plus un niveau suffisant dans l'équipe : MANAGER au moins pour modifier l'équipe et gérer ses membres, ADMIN pour la supprimer.
L'objet Équipe
| Champ | Type | Description |
|---|---|---|
id | UUID | Identifiant technique |
wid | chaîne (6) | Identifiant court |
customerId | UUID | Client de l'équipe |
name | chaîne (100) | Nom |
description | chaîne ou null | Description |
createdAt, updatedAt | chaîne ISO 8601 | Dates de création et de modification |
Niveaux d'équipe
| Niveau | Chiffre | Ce que le membre peut faire |
|---|---|---|
ADMIN | 1 | Tout sur l'équipe : la renommer, la supprimer, gérer ses membres et ses données |
MANAGER | 2 | Gérer les membres et toutes les données |
MEMBER | 3 | Ajouter, modifier, supprimer et voir les données (niveau par défaut) |
CONTRIBUTOR | 4 | Ajouter et voir les données |
VIEWER | 5 | Voir les données |
NONE | 0 | Aucun droit |
Ce que recouvrent « les données » d'une équipe est défini par votre application. Les droits d'équipe (appRights) sont une chaîne de 52 lettres au plus, de A à Z et de a à z, dont votre application fixe la signification.
Lister les équipes
/api/config/teamsDroit requis : teams.read. Pagination page et limit (1 à 100, défaut 20), filtres de portée customerWid ou customerId.
curl -s "https://api.wakastart.app/api/config/teams?customerWid=EXCLI1" \
-H "Authorization: Bearer $ACCESS_TOKEN"Réponse 200
{
"data": [
{
"id": "f6a8b0c2-5e7f-4a91-8c3d-4e5f6a7b8c90",
"wid": "EXTEA1",
"customerId": "c3d5e7f9-2b4c-4d6e-9f0a-1b2c3d4e5f60",
"name": "Accueil",
"description": "Équipe d'accueil des patients",
"createdAt": "2026-04-02T09:30:00.000Z",
"updatedAt": "2026-04-02T09:30:00.000Z"
}
],
"meta": { "page": 1, "limit": 20, "total": 1, "totalPages": 1 }
}Lire une équipe
/api/config/teams/{wid}Droit requis : teams.read. Réponse : l'objet Équipe.
Erreurs : 403 Team not found or not accessible ; 404 Team with WID <wid> not found.
Créer une équipe
/api/config/teamsDroit requis : teams.create.
| Champ | Type | Obligatoire | Contraintes |
|---|---|---|---|
name | chaîne | oui | 100 caractères au plus |
customerId | UUID | non | Client de l'équipe |
description | chaîne | non | — |
curl -s -X POST https://api.wakastart.app/api/config/teams \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ "name": "Cardiologie", "description": "Service de cardiologie" }'Réponse 201 : l'objet Équipe créé.
Modifier une équipe
/api/config/teams/{wid}Droit requis : teams.update. Champs facultatifs : name (100 caractères au plus), description.
Erreurs : 403 Vous n'avez pas les droits pour modifier cette équipe.
Supprimer une équipe
/api/config/teams/{wid}Droit requis : teams.delete. Retirez d'abord tous les membres.
Erreurs : 403 Vous n'avez pas les droits pour supprimer cette équipe ; 409 Impossible de supprimer cette équipe car elle possède encore des membres. Retirez d'abord les membres de l'équipe.
Lister les membres d'une équipe
/api/config/teams/{wid}/membersDroit requis : teams.read. Renvoie un tableau, sans pagination : un élément par membre, avec son niveau, ses droits d'équipe et sa fiche utilisateur.
curl -s https://api.wakastart.app/api/config/teams/EXTEA1/members \
-H "Authorization: Bearer $ACCESS_TOKEN"Réponse 200
[
{
"userId": "e5f7a9b1-4d6e-4f80-9b2c-3d4e5f6a7b80",
"teamId": "f6a8b0c2-5e7f-4a91-8c3d-4e5f6a7b8c90",
"teamLevel": "MANAGER",
"appRights": "AB",
"user": {
"id": "e5f7a9b1-4d6e-4f80-9b2c-3d4e5f6a7b80",
"wid": "EXUSR1",
"email": "alice@clinique-exemple.fr",
"firstName": "Alice",
"lastName": "Martin",
"isActive": true
}
}
]L'objet user reprend les champs de l'objet Utilisateur ; l'exemple n'en montre qu'une partie.
Ajouter un membre
/api/config/teams/{wid}/membersDroit requis : teams.members.add.
| Champ | Type | Obligatoire | Contraintes | Description |
|---|---|---|---|---|
userId | UUID | oui | Utilisateur du même client | Utilisateur à ajouter |
teamLevel | chaîne | non | ADMIN, MANAGER, MEMBER, CONTRIBUTOR, VIEWER, NONE | Défaut MEMBER |
appRights | chaîne | non | 52 lettres au plus, ^[a-zA-Z]*$ | Droits d'équipe |
curl -s -X POST https://api.wakastart.app/api/config/teams/EXTEA1/members \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"userId": "e5f7a9b1-4d6e-4f80-9b2c-3d4e5f6a7b80",
"teamLevel": "CONTRIBUTOR",
"appRights": "AB"
}'Erreurs : 403 Vous n'avez pas les droits pour ajouter des membres à cette équipe ; 409 La valeur du champ "<champs>" existe déjà. Veuillez en choisir une autre. : l'utilisateur est déjà membre.
Modifier le niveau d'un membre
/api/config/teams/{teamWid}/members/{userWid}/roleDroit requis : teams.members.add.
| Champ | Type | Obligatoire | Contraintes |
|---|---|---|---|
teamLevel | chaîne | oui | ADMIN, MANAGER, MEMBER, CONTRIBUTOR, VIEWER, NONE |
appRights | chaîne | non | 52 lettres au plus |
curl -s -X PATCH https://api.wakastart.app/api/config/teams/EXTEA1/members/EXUSR2/role \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ "teamLevel": "MANAGER" }'Erreurs : 403 Vous n'avez pas les droits pour modifier les niveaux dans cette équipe.
Retirer un membre
/api/config/teams/{teamWid}/members/{userWid}Droit requis : teams.members.add.
Erreurs : 403 Vous n'avez pas les droits pour retirer des membres de cette équipe.