Obtenir une organisation
GET /fapi/v1/organizations/{org_id} · appelé depuis l'hôte de connexion de l'environnement
Renvoie le profil d'une organisation tel que le voit son administrateur : nom, slug, statut, couleur de marque et version. C'est ce qu'affiche un écran de profil d'organisation. Le cookie __Host-idp_session de l'utilisateur authentifié est requis ; si le cookie est absent, expiré ou révoqué, la réponse est 401 unauthenticated. Une application de première partie sur une autre origine peut à la place envoyer son jeton d'accès à l'API front (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès à l'API front). L'utilisateur doit être un membre actif de l'organisation disposant de l'autorisation idp_org:read. Un utilisateur qui n'est pas membre reçoit 404 not_found, afin de ne pas révéler l'existence de l'organisation ; un membre sans l'autorisation reçoit 403 insufficient_permissions.
Avec @keenauth/js : await keenauth.organizations.get(orgId).
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
org_id : l'identifiant de l'organisation (org_…).
Aucun corps.
Réponse
200 OK avec ETag: "<version>".
| Champ | Description |
|---|---|
id |
org_…. |
name |
Nom affiché ; affichez-le en texte brut. |
slug |
Le slug de l'organisation. |
status |
active, disabled ou pending_deletion. |
brand_color |
#RRGGBB, ou null si non défini. |
deletion_due_at |
Uniquement pendant que l'organisation est en attente de suppression : date à laquelle elle sera supprimée. |
created_at, updated_at |
Dates au format RFC 3339. |
version |
La version portée par l'ETag ; envoyez-la dans If-Match lors d'une mise à jour. |
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 403 | insufficient_permissions |
L'utilisateur ne dispose pas de idp_org:read dans l'organisation. |
| 404 | not_found |
Aucune organisation de ce type pour cet utilisateur ; un identifiant inconnu, mal formé ou appartenant à une autre organisation donne la même réponse. |
| 503 | service_unavailable |
Temporairement indisponible ; réessayez après Retry-After. |
Exemple
curl https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
{
"id": "org_01jbz6x8kq3m2n4p5r6s7t8v9a",
"name": "Acme",
"slug": "acme",
"status": "active",
"brand_color": "#112233",
"created_at": "2026-11-03T09:00:00Z",
"updated_at": "2026-11-03T09:30:00Z",
"version": 4
}