Notificaciones
Las notificaciones de la persona dueña de la key, su estado de lectura y sus preferencias de aviso.
Las notificaciones son los avisos que Reclee le manda a una persona: una longlist que cerró o se pausó, una vacante que le asignaron, un candidato del sourcing que se postuló, alguien nuevo en el equipo. Son personales: con una API key lees y marcas las notificaciones de la persona dueña de la key, nunca las de otro miembro.
Una notificación vence a los 30 días: la lista y el contador solo cuentan las de los últimos 30 días. Además de leerlas, puedes marcarlas como leídas o no leídas y cambiar qué avisos recibe la persona, en la app (IN_APP) y por email (EMAIL).
Lista
GET /notifications
/notificationsDevuelve las notificaciones de los últimos 30 días, de la más nueva a la más vieja, como un array. No usa la paginación estándar: trae hasta limit filas (como máximo 200), y el header X-Has-More: true avisa que había más de las que vinieron.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| unreadOnly | boolean | Opcional | true trae solo las no leídas. |
| type | enum | Opcional | Solo un tipo de notificación (ver la tabla de abajo). |
| jobPostId | uuid | Opcional | Solo las de esa vacante. |
| limit | integer | Opcional | Cuántas traer, de 1 a 200. Default 200. |
Un parámetro desconocido contesta 400 INVALID.
curl -i "https://app.reclee.com/api/v1/notifications?unreadOnly=true&limit=20" \
-H "Authorization: Bearer rcl_..."Respuesta (extracto, dos notificaciones):
[
{
"id": "6a1d2b3c-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"createdAt": "2026-10-21T18:42:10.000Z",
"readAt": null,
"count": 1,
"day": "2026-10-21",
"daysAgo": 1,
"jobPostId": "c2e4f6a8-1b3d-4f5a-9c7e-2d4f6a8b0c1e",
"type": "LONGLIST_CLOSED",
"longlistId": "8f9e0d1c-2b3a-4c5d-9e8f-7a6b5c4d3e2f",
"jobPostTitle": "Backend Developer Sr.",
"profileCount": 48,
"closeReason": "PROFILE_CAP",
"closedBy": null
},
{
"id": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
"createdAt": "2026-10-20T11:05:00.000Z",
"readAt": null,
"count": 3,
"day": "2026-10-20",
"daysAgo": 2,
"jobPostId": "c2e4f6a8-1b3d-4f5a-9c7e-2d4f6a8b0c1e",
"type": "NEW_APPLICATION_RECEIVED",
"jobPostTitle": "Backend Developer Sr."
}
]Todas las notificaciones traen id, createdAt, readAt (null si no está leída), count (cuántos avisos iguales agrupa), day (el día del calendario del workspace), daysAgo (0 es hoy) y jobPostId (null si no es de una vacante o ya no se puede ver). El resto de los campos depende de type; cualquier sujeto que se haya borrado llega como null:
type | Campos propios |
|---|---|
LONGLIST_CLOSED | longlistId, jobPostTitle, profileCount, closeReason, closedBy ({ name, initials } o null si cerró sola) |
LONGLIST_PAUSED | longlistId, jobPostTitle, profileCount, pauseReason (PROFILE_CAP, LOW_PERFORMANCE o DROUGHT) |
SOURCING_FAILED | longlistId, jobPostTitle, failure |
JOB_POST_ASSIGNED | jobPostTitle, actor, pipelineCount, openDays |
SOURCED_CANDIDATE_APPLIED | candidate, profileId, jobPostTitle, fit |
NEW_APPLICATION_RECEIVED | jobPostTitle |
SHORTLIST_VIEWED | jobPostTitle, shortlistStageId |
OPEN_APPLICATION_RECEIVED | (ninguno) |
APPLICATION_WITHDRAWN | candidate, profileId, jobPostTitle, stage ({ name, templateKey }) |
MEMBER_JOINED | member, emailDomain |
OWNERSHIP_TRANSFERRED | giver, giverStays (el rol con el que quedó quien transfirió, u OUT si se fue) |
CV_IMPORT_FINISHED | cvImportJobId, created, existing, failed |
MATCH_SCORES_RECALCULATED | jobPostTitle, tally ({ scored, skipped, failed, remaining }) |
MATCH_SCORE_MOVED sigue existiendo como valor de type en notificaciones viejas (con jobPostTitle), pero ya no se genera.
GET /notifications/unread-count
/notifications/unread-countDevuelve cuántas notificaciones no leídas de los últimos 30 días tiene la persona.
curl https://app.reclee.com/api/v1/notifications/unread-count \
-H "Authorization: Bearer rcl_..."Respuesta:
{ "count": 4 }Estado de lectura
POST /notifications/read
/notifications/readMarca como leídas las notificaciones que le pases. Devuelve en moved cuántas cambiaron de verdad: una que ya estaba leída, que no es tuya o que no existe no cuenta, y no es un error.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| ids | uuid[] | Sí | Los id de las notificaciones, hasta 200. |
curl -X POST https://app.reclee.com/api/v1/notifications/read \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "ids": ["6a1d2b3c-4e5f-4a6b-8c7d-9e0f1a2b3c4d"] }'Respuesta:
{ "moved": 1 }POST /notifications/read-all
/notifications/read-allMarca como leídas todas las notificaciones no leídas de la persona. No lleva body. Devuelve cuántas cambiaron.
curl -X POST https://app.reclee.com/api/v1/notifications/read-all \
-H "Authorization: Bearer rcl_..."Respuesta:
{ "moved": 4 }DELETE /notifications/{notificationId}/read
/notifications/{notificationId}/readVuelve a marcar una notificación como no leída: borra la marca de lectura, no la notificación. Contesta 204 sin body si cambió, y 404 NOT_FOUND si no había nada que cambiar (la notificación no es tuya, no existe o ya estaba sin leer).
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| notificationId | uuid | Sí | El id de la notificación (path). |
curl -X DELETE https://app.reclee.com/api/v1/notifications/6a1d2b3c-4e5f-4a6b-8c7d-9e0f1a2b3c4d/read \
-H "Authorization: Bearer rcl_..."Preferencias
GET /notifications/preferences
/notifications/preferencesDevuelve, para cada tipo de notificación, si la persona la recibe en la app (inApp) y por email (email). Las preferencias son de la persona, no del workspace: valen en todos los workspaces de los que es miembro.
Por defecto todo llega a la app. Por email llegan de entrada LONGLIST_CLOSED, LONGLIST_PAUSED, SOURCING_FAILED, JOB_POST_ASSIGNED y OWNERSHIP_TRANSFERRED; los demás tipos llegan por email solo si la persona lo activa.
curl https://app.reclee.com/api/v1/notifications/preferences \
-H "Authorization: Bearer rcl_..."Respuesta (extracto):
[
{ "type": "LONGLIST_CLOSED", "inApp": true, "email": true },
{ "type": "NEW_APPLICATION_RECEIVED", "inApp": true, "email": false },
{ "type": "MEMBER_JOINED", "inApp": false, "email": false }
]PATCH /notifications/preferences
/notifications/preferencesPrende o apaga avisos, de a varios. Solo cambia los pares tipo-canal que mandas; el resto queda como estaba. Devuelve la lista completa de preferencias, con la forma de GET /notifications/preferences. Repetir el mismo cambio no hace nada, así que reintentar es seguro.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| changes | object[] | Sí | Al menos un cambio. Cada par type + channel puede aparecer una sola vez. |
| changes[].type | enum | Sí | El tipo de notificación (cualquiera de la tabla de arriba salvo MATCH_SCORE_MOVED). |
| changes[].channel | enum | Sí | IN_APP o EMAIL. |
| changes[].enabled | boolean | Sí | true la prende, false la apaga. |
curl -X PATCH https://app.reclee.com/api/v1/notifications/preferences \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"changes": [
{ "type": "NEW_APPLICATION_RECEIVED", "channel": "EMAIL", "enabled": true },
{ "type": "MEMBER_JOINED", "channel": "IN_APP", "enabled": false }
]
}'Si un cambio de la tanda falla a mitad de camino, los anteriores pueden haber quedado guardados: ante un 500, vuelve a leer las preferencias antes de reintentar.