Obtener una organización
GET /fapi/v1/organizations/{org_id} · llamado desde el host de inicio de sesión del entorno
Devuelve el perfil de una organización tal como lo ve su administrador: nombre, slug, estado, color de marca y versión. Esto es lo que muestra una pantalla de perfil de organización. Requiere la cookie __Host-idp_session del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve 401 unauthenticated. Una aplicación de primera parte en otro origen puede enviar en su lugar su token de acceso de la API frontal (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso de la API frontal). El usuario debe ser miembro activo de la organización con el permiso idp_org:read. Un usuario que no es miembro recibe 404 not_found, de modo que no se revela la existencia de la organización; un miembro sin el permiso recibe 403 insufficient_permissions.
Con @keenauth/js: await keenauth.organizations.get(orgId).
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
org_id: el identificador de la organización (org_…).
Sin cuerpo.
Respuesta
200 OK con ETag: "<versión>".
| Campo | Descripción |
|---|---|
id |
org_…. |
name |
Nombre para mostrar; muéstrelo como texto sin formato. |
slug |
El slug de la organización. |
status |
active, disabled o pending_deletion. |
brand_color |
#RRGGBB, o null si no está definido. |
deletion_due_at |
Solo mientras la organización está pendiente de eliminación: cuándo se eliminará. |
created_at, updated_at |
Fechas RFC 3339. |
version |
La versión que lleva el ETag; envíela como If-Match en una actualización. |
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 401 | unauthenticated |
No hay una cookie de sesión válida. |
| 403 | insufficient_permissions |
El usuario no tiene idp_org:read en la organización. |
| 404 | not_found |
No existe tal organización para este usuario; un identificador desconocido, con formato incorrecto o ajeno recibe la misma respuesta. |
| 503 | service_unavailable |
No disponible temporalmente; reintente después de Retry-After. |
Ejemplo
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
}