Ignorer une suggestion d'organisation
POST /fapi/v1/me/organization-suggestions/{domain_id}:dismiss · appelé depuis l'hôte de connexion de l'environnement
Ignore une suggestion issue de Lister mes suggestions d'organisation. Le compteur est conservé par organisation : une organisation ayant plusieurs domaines suggérés ne compte que comme une seule suggestion. Après le troisième rejet, l'organisation n'est plus suggérée (hidden vaut true), et les rejets ou adhésions ultérieurs renvoient 404 not_found. Deux rejets simultanés comptent tous les deux. Nécessite le cookie __Host-idp_session de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie 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).
Avec @keenauth/js : await keenauth.organizations.dismissSuggestion(id).
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<hôte de connexion>. |
domain_id : l'id de la suggestion (odm_…).
Aucun corps (un objet JSON vide est accepté).
Réponse
200 OK avec {"dismiss_count": 1, "hidden": false}. dismiss_count est compris entre 1 et 3.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session ni jeton d'accès à l'API front valide. |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 404 | not_found |
Le domaine n'est pas une suggestion pour cet utilisateur, ou il a déjà été ignoré trois fois. |
| 503 | temporarily_unavailable |
L'annuaire des adhésions n'a pas répondu ; réessayez plus tard. |
Exemple
curl -X POST https://example.keenauth.app/fapi/v1/me/organization-suggestions/odm_01j9a5c4000000000000000001:dismiss \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
{
"dismiss_count": 1,
"hidden": false
}
Données personnelles
Cet point d'accès traite des données personnelles : adhésions et invitations aux organisations. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.