# Elenca i miei suggerimenti di organizzazione

`GET /fapi/v1/me/organization-suggestions` · chiamato dall'host di accesso dell'ambiente

Elenca le organizzazioni a cui l'utente autenticato è invitato ad aderire grazie al dominio di uno dei suoi indirizzi email verificati. Un'organizzazione viene suggerita quando è attiva, ha verificato quel dominio con la cattura del dominio impostata su `suggest`, e l'utente non ha un'appartenenza in essa (anche un'appartenenza rimossa o abbandonata conta, quindi non viene mai suggerita di nuovo). Viene restituito un elemento per organizzazione, in ordine di slug, per un massimo di 20. Un'organizzazione che l'utente ha ignorato tre volte non viene elencata. Se il ruolo di membro predefinito dell'ambiente non può essere concesso tramite cattura del dominio (un ruolo amministrativo, un ruolo privilegiato, oppure un ruolo con autorizzazioni di sistema oltre alla lettura dell'organizzazione e dei suoi membri), l'elenco è vuoto. La lettura non modifica nulla e non richiede una sessione verificata di recente. Richiede il cookie `__Host-idp_session` dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce `401 unauthenticated`. Un'app first-party su un'altra origine può invece inviare il proprio access token Front API (`Authorization: DPoP <token>` con una prova DPoP; vedi [Token di accesso Front API](/docs/api/fapi/front-api-token)).

Con `@keenauth/js`: `await keenauth.organizations.suggestions()`.

## Richiesta

Intestazioni:

| Intestazione | Obbligatoria | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificatore dell'SDK. |

Nessun parametro di query. Nessun corpo.

## Risposta

`200 OK` con `{"data": [...]}`. La risposta non viene memorizzata nella cache (`Cache-Control: no-store`).

Ciascun elemento: `id` (`odm_…`, il record del dominio verificato; usalo per aderire o ignorare), `domain` (il dominio email che ha corrisposto) e `organization` con `id` (`org_…`), `slug` e `name` (nome visualizzato con i caratteri di controllo e bidirezionali rimossi; lo slug quando l'organizzazione non ha un nome; visualizzalo come testo semplice).

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 401 | `unauthenticated` | Cookie di sessione o access token Front API assente o non valido. |
| 503 | `temporarily_unavailable` | La directory delle appartenenze non ha risposto; riprova più tardi. |

## Esempio

```bash
curl https://example.keenauth.app/fapi/v1/me/organization-suggestions \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

```json
{
  "data": [
    {
      "id": "odm_01j9a5c4000000000000000001",
      "domain": "acme.example",
      "organization": {
        "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
        "slug": "acme",
        "name": "Acme"
      }
    }
  ]
}
```

## Dati personali

Questo endpoint contiene dati personali: appartenenze e inviti alle organizzazioni. [Dati personali nelle API di KeenAuth](/docs/policies/personal-data) descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.