API de Nest
Tres lecturas: el espacio, su gente y las notificaciones. Ninguna escritura.
Base: https://nest.eel.software/api/public/v1
Nest es la superficie más pequeña de la suite. Tres lecturas y ni una sola escritura.
| Método | Ruta | Permiso | Qué devuelve |
|---|---|---|---|
GET |
/workspace |
nest:workspace:read |
id, name, created_at |
GET |
/workspace/members |
nest:workspace:read |
El directorio completo |
GET |
/notifications |
nest:notifications:read |
El buzón de la suite, del más nuevo al más viejo |
/workspace es la forma más rápida de comprobar que una credencial sirve. Ver
Tu primera petición.
Directorio y notificaciones
El directorio llega completo. /workspace/members devuelve a todo el
mundo en una sola respuesta: no acepta cursor, ni limit, ni búsqueda.
Filtra a una persona por correo o aísla un solo miembro del lado del
cliente, sobre esa lista.
El feed de notificaciones se lee desde fuera y se marca desde dentro.
/notifications expone el buzón de la suite, del más nuevo al más viejo.
Fíltralo con recipient_id, source_app o unread_only. Un token de
usuario muestra por defecto las notificaciones de esa persona: añade
recipient_id para ver las de alguien más, o all=true para ver todo el
espacio. Una clave de espacio ya ve a todo el mundo, sin necesidad de
ningún parámetro. Marcar leído, marcar todo leído y el contador de no
leídas viven dentro de las aplicaciones: un panel externo puede mostrar el
feed, no vaciarlo.
Escritura y herramientas de MCP
Invitar gente, cambiar roles, conceder acceso a una app y crear espacios
pasa por Nest, la aplicación, con una persona detrás de cada acción: la API
pública solo lee, sin POST ni PATCH.
La lista de tus espacios y la resolución de referencias entre apps viven
como herramientas de MCP en vez de rutas HTTP:
nest_list_workspaces devuelve tus espacios, y suite_resolve_refs junto
con suite_search resuelven y buscan referencias (EER) entre aplicaciones.