Listar mis organizaciones

GET /fapi/v1/me/organizations · llamado desde el host de inicio de sesión del entorno

Lista las organizaciones a las que el usuario autenticado puede cambiar en una aplicación: organizaciones en las que el usuario tiene una pertenencia activa, que están activas y para las que la aplicación está habilitada, en orden de slug, con un máximo de 100. Es la lista que muestra un selector de organización y la misma que ofrece el selector alojado de organizaciones al iniciar sesión, por lo que nunca muestra una organización que la aplicación no puede usar. Ningún elemento se marca como actual: la organización a la que está vinculado el token de tu aplicación es la claim org_id del token. La lectura no cambia nada y no requiere una sesión verificada recientemente. Requiere la cookie __Host-idp_session del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve 401 unauthenticated.

Con @keenauth/js: await keenauth.organizations.listMine().

Solicitud

Encabezados:

Encabezado	Obligatorio	Descripción
`Idp-Client`	sí	Identificador del SDK.

Parámetros de consulta:

Parámetro	Obligatorio	Descripción
`client_id`	sí	El `client_id` de la aplicación de primera parte en la que se ejecuta el selector.

Sin cuerpo.

Respuesta

200 OK con {"data": [...], "truncated": false}.

Cada elemento: id (org_…, la misma forma que la claim org_id del token y el parámetro organization), slug, name (nombre visible con los caracteres de control y bidireccionales eliminados; el slug cuando la organización no tiene nombre; muéstralo como texto plano). truncated es true cuando el usuario tiene más organizaciones de este tipo que las listadas.

Errores

Estado	Código	Cuándo
401	`unauthenticated`	No hay una cookie de sesión válida.
403	`headless_not_allowed`	La aplicación es una aplicación de terceros.
422	`validation_failed`	`client_id` falta, está vacío, tiene más de 255 caracteres, se envía más de una vez o es desconocido (`/client_id`).
503	`temporarily_unavailable`	El directorio de pertenencias no respondió; vuelve a intentarlo más tarde.

Ejemplo

curl "https://example.keenauth.app/fapi/v1/me/organizations?client_id=app_01j9zzzzzzzzzzzzzzzzzzzz" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
      "slug": "acme",
      "name": "Acme"
    }
  ],
  "truncated": false
}

Datos personales

Este endpoint contiene datos personales: pertenencias a organizaciones e invitaciones. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíes categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.