Recupera un'organizzazione

GET /fapi/v1/organizations/{org_id} · chiamato dall'host di accesso dell'ambiente

Restituisce il profilo di un'organizzazione così come lo vede il suo amministratore: nome, slug, stato, colore del brand e versione. È ciò che mostra una schermata del profilo dell'organizzazione. 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 dell'API front (Authorization: DPoP <token> con una prova DPoP; vedi Access token dell'API front). L'utente deve essere un membro attivo dell'organizzazione con l'autorizzazione idp_org:read. Un utente che non è membro riceve 404 not_found, così l'esistenza dell'organizzazione non viene rivelata; un membro senza l'autorizzazione riceve 403 insufficient_permissions.

Con @keenauth/js: await keenauth.organizations.get(orgId).

Richiesta

Header:

Header Obbligatorio Descrizione
Idp-Client sì Identificativo dell'SDK.

org_id: l'identificativo dell'organizzazione (org_…).

Nessun corpo.

Risposta

200 OK con ETag: "<version>".

Campo Descrizione
id org_….
name Nome visualizzato; mostralo come testo semplice.
slug Lo slug dell'organizzazione.
status active, disabled o pending_deletion.
brand_color #RRGGBB, oppure null se non impostato.
deletion_due_at Solo mentre l'organizzazione è in attesa di cancellazione: quando verrà cancellata.
created_at, updated_at Orari RFC 3339.
version La versione contenuta nell'ETag; inviala come If-Match in un aggiornamento.

Errori

Stato Codice Quando
401 unauthenticated Cookie di sessione assente o non valido.
403 insufficient_permissions L'utente non ha idp_org:read nell'organizzazione.
404 not_found Nessuna organizzazione del genere per questo utente; un identificativo sconosciuto, malformato o di un'altra organizzazione riceve la stessa risposta.
503 service_unavailable Temporaneamente non disponibile; riprova dopo Retry-After.

Esempio

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
}