Bir kuruluşu getirin

GET /fapi/v1/organizations/{org_id} · ortamın oturum açma sunucusundan çağrılır

Bir kuruluşun profilini yöneticisinin gördüğü şekliyle döndürür: ad, slug, durum, marka rengi ve sürüm. Bir kuruluş profil ekranında gösterilen bilgi budur. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döner. Başka bir kökendeki birinci taraf bir uygulama, bunun yerine ön yüz API erişim belirtecini gönderebilir (Authorization: DPoP <token> ve bir DPoP kanıtıyla; bkz. Ön yüz API erişim belirteci). Kullanıcı kuruluşun aktif bir üyesi olmalı ve idp_org:read iznine sahip olmalıdır. Üye olmayan bir kullanıcı 404 not_found alır; böylece kuruluşun varlığı açığa çıkmaz. İzni olmayan bir üye ise 403 insufficient_permissions alır.

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

İstek

Başlıklar:

Başlık	Zorunlu	Açıklama
`Idp-Client`	evet	SDK tanımlayıcısı.

org_id: kuruluş tanımlayıcısı (org_…).

Gövde yok.

Yanıt

ETag: "<version>" ile birlikte 200 OK.

Alan	Açıklama
`id`	`org_…`.
`name`	Görünen ad; düz metin olarak gösterin.
`slug`	Kuruluşun slug değeri.
`status`	`active`, `disabled` veya `pending_deletion`.
`brand_color`	`#RRGGBB`, ayarlanmamışsa `null`.
`deletion_due_at`	Yalnızca kuruluş silinmeyi beklerken: ne zaman silineceği.
`created_at`, `updated_at`	RFC 3339 zamanları.
`version`	`ETag` içinde taşınan sürüm; bir güncellemede `If-Match` olarak gönderin.

Hatalar

Durum	Kod	Ne zaman
401	`unauthenticated`	Geçerli bir oturum çerezi yoksa.
403	`insufficient_permissions`	Kullanıcının kuruluşta `idp_org:read` izni yoksa.
404	`not_found`	Bu kullanıcı için böyle bir kuruluş yoksa; bilinmeyen, hatalı biçimli veya başkasına ait bir tanımlayıcı aynı yanıtı verir.
503	`service_unavailable`	Geçici olarak kullanılamıyorsa; `Retry-After` sonrası yeniden deneyin.

Örnek

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
}