Aller au contenu
Organisation et réglages/Lister les membres

Lister les membres

Liste les membres de l'organisation, avec leur rôle et leur profil.

Réservé au propriétaire et à Marketing Ops, comme la page des membres. La liste est paginée : renvoyez nextCursor dans cursor pour lire la page suivante.

Appel

RepèreValeur
AdresseGET /api/v1/members
Par son nomPOST /api/v1/tools/list_members, la réponse sous data
Nom de l'outillist_members
Qui peut appelerLe propriétaire et Marketing Ops.
Par MCPOui, en lecture.

Paramètres

Les paramètres suivent l'adresse, après ?.

ParamètreRequisType et limitesÀ quoi il sert
cursornontexte, ou nullLe curseur rendu par la page précédente. Absent pour la première page.
limitnonnombre entier, de 1 à 100, 50 par défautLe nombre de membres par page.

Exemple

curl "$MARVESTO_URL/api/v1/members" \
  -H "x-api-key: $MARVESTO_API_KEY"

Réponse

members (identifiant, rôle, date d'arrivée, nom, e-mail), count, nextCursor et hasMore.

Refus

Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.