Provisioning utilisateurs
Inviter, lister et révoquer les membres d'un tenant via l'API publique v2 (PAT).
L'API de provisioning utilisateurs permet d'automatiser l'onboarding et l'offboarding des membres d'un tenant Architecture Platform depuis votre IdM, votre outil RH ou un script CI.
Ce guide visait /api/v1 jusqu'au 2026-10-09. La v1 a été retirée de
l'API publique ; tout ce qui suit est en v2. Trois changements demandent une
adaptation, pas un remplacement de préfixe :
- Les membres ont leur propre racine :
/tenant/members, et non/tenant/invitations/members. Un membre n'est pas une invitation. - L'identifiant d'un membre change :
memberId(UUID stable) à la place dusubOIDC — un identifiant interne qui couplait votre intégration à notre annuaire d'identités. - Un membre n'apparaît plus qu'une fois, avec
rolesen tableau. La v1 rendait une ligne par rôle accordé : une personne cumulant deux rôles y figurait deux fois.
Tous les endpoints ci-dessous nécessitent un PAT dont le porteur a le rôle
tenant-admin sur le tenant cible. Un PAT créé par un architect ou un
contributor recevra un 403.
Base URL
https://api.arch-platform.com/api/v2Endpoints
| Method | Path | Scope | Description |
|---|---|---|---|
POST | /tenant/invitations | write | Invite une personne par email avec un rôle |
GET | /tenant/invitations | read | Liste les invitations (tous statuts) |
GET | /tenant/invitations/{invitationId} | read | Détail d'une invitation |
POST | /tenant/invitations/{invitationId}/revoke | write | Invalide une invitation en attente |
GET | /tenant/members | read | Liste les membres actifs et leurs rôles |
GET | /tenant/members/{memberId} | read | Détail d'un membre |
PATCH | /tenant/members/{memberId} | write | Change le rôle d'un membre |
DELETE | /tenant/members/{memberId} | write | Retire l'accès d'un membre |
Inviter une personne
tenant-admin,
architect, portfolio-manager, contributor, viewer, arb-member.
Une valeur inconnue est refusée en 400, et le corps nomme les valeurs
admises.Requête
curl -X POST https://api.arch-platform.com/api/v2/tenant/invitations \
-H "Authorization: Bearer arc_pat_xxx" \
-H "Content-Type: application/json" \
-d '{
"email": "jane.doe@acme.com",
"arbRole": "architect"
}'Réponse 201 Created
Avec un en-tête Location désignant l'invitation créée — vous n'avez pas à
refaire un GET pour connaître sa date d'expiration.
Location: /api/v2/tenant/invitations/5f3a8c2e-9b1d-4e7a-a8f4-1c2d3e4f5a6b{
"invitationId": "5f3a8c2e-9b1d-4e7a-a8f4-1c2d3e4f5a6b",
"email": "jane.doe@acme.com",
"arbRole": "architect",
"status": "PENDING",
"invitedByEmail": "admin@acme.com",
"expiresAt": "2026-06-30T10:00:00Z",
"createdAt": "2026-06-23T10:00:00Z",
"acceptedAt": null,
"revokedAt": null
}Erreurs possibles
| Statut | Cause |
|---|---|
400 | Adresse absente ou mal formée, ou rôle inconnu |
402 | Le quota d'utilisateurs de votre plan est atteint |
403 | Scope du PAT ≠ write, ou porteur sans tenant-admin |
Il n'y a pas de 409. Ce guide en annonçait un — « une invitation
PENDING existe déjà pour cet email ». C'est faux : si une invitation en
attente existe, elle est révoquée et remplacée par la nouvelle.
L'opération ne refuse pas, elle ré-invite. Un 409 décrivait un refus qui
n'arrive jamais, et vous auriez écrit du code mort pour le traiter.
Révoquer une invitation
⚠️ C'est un POST …/revoke, et non un DELETE : la révocation est une
transition d'état. La ligne survit avec status: "REVOKED" et une date, et
elle reste listée. Un DELETE aurait annoncé une disparition qui n'a pas
lieu.
curl -X POST \
https://api.arch-platform.com/api/v2/tenant/invitations/5f3a8c2e-9b1d-4e7a-a8f4-1c2d3e4f5a6b/revoke \
-H "Authorization: Bearer arc_pat_xxx"Réponse 200 OK avec l'invitation dans son nouvel état.
Lister les membres actifs
curl https://api.arch-platform.com/api/v2/tenant/members \
-H "Authorization: Bearer arc_pat_xxx"Réponse 200 OK
{
"items": [
{
"memberId": "7c1b2d3e-0000-4000-8000-000000000001",
"email": "alice@acme.com",
"roles": ["tenant-admin"],
"memberSince": "2026-01-15T09:30:00Z"
},
{
"memberId": "7c1b2d3e-0000-4000-8000-000000000002",
"email": "bob@acme.com",
"roles": ["architect", "arb-member"],
"memberSince": "2026-03-22T14:12:00Z"
}
],
"page": {
"limit": 50,
"nextCursor": null,
"previousCursor": null,
"totalItems": 2
}
}Bob n'apparaît qu'une fois, avec ses deux rôles. En v1, il figurait deux fois — une ligne par rôle accordé — et il vous appartenait de dédoublonner.
Deux champs de la v1 ne sont plus exposés : userSub, un identifiant
d'annuaire, et source (SIGNUP / INVITATION / SSO_JIT), qui décrivait
notre mécanique de provisionnement interne. Si source vous est utile,
écrivez-nous : il sera ajouté délibérément, pas par héritage.
Changer le rôle d'un membre
Le PATCH attend application/merge-patch+json et remplace les rôles du
membre par celui demandé — il ne les ajoute pas. Un membre qui cumulait deux
rôles n'en aura plus qu'un.
curl -X PATCH \
https://api.arch-platform.com/api/v2/tenant/members/7c1b2d3e-0000-4000-8000-000000000002 \
-H "Authorization: Bearer arc_pat_xxx" \
-H "Content-Type: application/merge-patch+json" \
-d '{"arbRole": "viewer"}'Réponse 200 OK avec le membre à jour.
Retirer un membre
Action irréversible. Le membre perd immédiatement l'accès au tenant,
mais son compte global subsiste (il peut être ré-invité plus tard, et
retrouvera le même memberId). Les notices et sessions qu'il a créées
restent attribuées : l'historique d'audit est préservé.
curl -X DELETE \
https://api.arch-platform.com/api/v2/tenant/members/7c1b2d3e-0000-4000-8000-000000000002 \
-H "Authorization: Bearer arc_pat_xxx"Réponse 204 No Content. Le membre quitte la collection et son GET répond
ensuite 404.
Un memberId inconnu répond 404 — et non 403 s'il appartient à une autre
organisation : on ne révèle pas son existence.
Script d'offboarding RH (exemple Python)
import requests, csv, os
PAT = os.environ["ARCH_PAT"]
BASE = "https://api.arch-platform.com/api/v2"
HEADERS = {"Authorization": f"Bearer {PAT}"}
# 1. Les membres actifs — en PAGINANT.
# ⚠️ Lire seulement la première page donnerait au plus 200 membres sans le
# dire, et des sortants resteraient en place sans erreur visible.
membres, curseur = [], None
while True:
params = {"limit": 200}
if curseur:
params["cursor"] = curseur
page = requests.get(f"{BASE}/tenant/members", headers=HEADERS, params=params).json()
membres += page["items"]
curseur = page["page"]["nextCursor"]
if not curseur:
break
sortants = {row["email"].strip().lower() for row in csv.DictReader(open("leavers.csv"))}
# 2. Retire ceux dont l'adresse figure parmi les sortants RH.
for m in membres:
if m["email"].strip().lower() in sortants:
r = requests.delete(f"{BASE}/tenant/members/{m['memberId']}", headers=HEADERS)
print(f"{m['email']} → {r.status_code}")