# Organisationsvorschlag ablehnen

`POST /fapi/v1/me/organization-suggestions/{domain_id}:dismiss` · wird vom Anmelde-Host der Umgebung aufgerufen

Lehnt einen Vorschlag aus [Meine Organisationsvorschläge auflisten](/docs/api/fapi/me/organization-suggestions/list) ab. Die Anzahl wird pro Organisation erfasst: Eine Organisation mit mehreren vorgeschlagenen Domains ergibt einen Vorschlag. Nach der dritten Ablehnung wird die Organisation nicht mehr vorgeschlagen (`hidden` ist `true`), und weitere Ablehnungen oder Beitritte liefern `404 not_found`. Zwei gleichzeitige Ablehnungen zählen beide. Erforderlich ist das Cookie `__Host-idp_session` des authentifizierten Benutzers; fehlt das Cookie, ist es abgelaufen oder widerrufen, wird `401 unauthenticated` zurückgegeben. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (`Authorization: DPoP <token>` mit einem DPoP-Proof; siehe [Front-API-Zugriffstoken](/docs/api/fapi/front-api-token)).

Mit `@keenauth/js`: `await keenauth.organizations.dismissSuggestion(id)`.

## Anfrage

Header:

| Header | Erforderlich | Beschreibung |
| --- | --- | --- |
| `Idp-Client` | ja | Kennung des SDK. |
| `Origin` | ja | Muss genau `https://<Anmelde-Host>` sein. |

`domain_id`: die `id` des Vorschlags (`odm_…`).

Kein Body (ein leeres JSON-Objekt wird akzeptiert).

## Antwort

`200 OK` mit `{"dismiss_count": 1, "hidden": false}`. `dismiss_count` liegt zwischen 1 und 3.

## Fehler

| Status | Code | Wann |
| --- | --- | --- |
| 401 | `unauthenticated` | Kein gültiges Sitzungs-Cookie oder Front-API-Zugriffstoken. |
| 403 | `origin_not_allowed` | `Origin` fehlt oder ist falsch. |
| 404 | `not_found` | Die Domain ist für diesen Benutzer kein Vorschlag oder wurde bereits dreimal abgelehnt. |
| 503 | `temporarily_unavailable` | Das Mitgliederverzeichnis hat nicht geantwortet; wiederholen Sie die Anfrage später. |

## Beispiel

```bash
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
```

```json
{
  "dismiss_count": 1,
  "hidden": false
}
```

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Organisationsmitgliedschaften und Einladungen. [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Übermitteln Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in irgendeinem Feld.