Listar mis sugerencias de organización

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

Lista las organizaciones a las que el usuario autenticado está invitado a unirse por el dominio de una de sus direcciones de correo electrónico verificadas. Se sugiere una organización cuando está activa, ha verificado ese dominio con la captura por dominio establecida en suggest, y el usuario no tiene membresía en ella (una membresía eliminada o abandonada también cuenta, por lo que nunca vuelve a sugerirse). Se devuelve un elemento por organización, en orden de slug, con un máximo de 20. Una organización que el usuario descartó tres veces no aparece en la lista. Si el rol de miembro predeterminado del entorno no puede concederse mediante la captura por dominio (un rol de administrador, un rol privilegiado o un rol con permisos del sistema más allá de leer la organización y sus miembros), la lista está vacía. 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. 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).

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

Solicitud

Encabezados:

Sin parámetros de consulta. Sin cuerpo.

Respuesta

200 OK con {"data": [...]}. La respuesta no se almacena en caché (Cache-Control: no-store).

Cada elemento: id (odm_…, el registro de dominio verificado; úselo para unirse o descartar), domain (el dominio de correo electrónico que coincidió) y organization con id (org_…), slug y name (nombre para mostrar con los caracteres de control y bidireccionales eliminados; el slug cuando la organización no tiene nombre; muéstrelo como texto sin formato).

Errores

Ejemplo

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

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

Datos personales

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