Dismiss an organization suggestion
POST /fapi/v1/me/organization-suggestions/{domain_id}:dismiss · called from the environment's sign-in host
Dismisses a suggestion from List my organization suggestions. The count is kept per organization: an organization with several suggested domains is one suggestion. After the third dismissal the organization is no longer suggested (hidden is true), and later dismissals or joins return 404 not_found. Two simultaneous dismissals both count. Requires the authenticated user's __Host-idp_session cookie; if the cookie is missing, expired, or revoked, returns 401 unauthenticated. A first-party app on another origin can instead send its front API access token (Authorization: DPoP <token> with a DPoP proof; see Front API access token).
With @keenauth/js: await keenauth.organizations.dismissSuggestion(id).
Request
Headers:
| Header | Required | Description |
|---|---|---|
Idp-Client |
yes | SDK identifier. |
Origin |
yes | Must be exactly https://<sign-in host>. |
domain_id: the suggestion's id (odm_…).
No body (an empty JSON object is accepted).
Response
200 OK with {"dismiss_count": 1, "hidden": false}. dismiss_count is between 1 and 3.
Errors
| Status | Code | When |
|---|---|---|
| 401 | unauthenticated |
No valid session cookie or front API access token. |
| 403 | origin_not_allowed |
Origin is missing or wrong. |
| 404 | not_found |
The domain is not a suggestion for this user, or it was already dismissed three times. |
| 503 | temporarily_unavailable |
The membership directory did not answer; retry later. |
Example
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
}
Personal data
This endpoint carries personal data: organization memberships and invitations. Personal data in the KeenAuth APIs describes what is stored, how long it is kept and how it is deleted. Do not send special categories of personal data (health, biometric data, religion, political opinions, sexual orientation) in any field.