Perfiles
Lo que tu workspace sabe y registró sobre una persona, colgado de su perfil, con notas, etiquetas, listas e historial.
Estas rutas cuelgan de una persona (/profiles/{profileId}) y devuelven lo que tu workspace registró sobre ella: sus notas, sus etiquetas, las listas donde está y su historial. Todo está acotado al workspace de tu API key. Otro workspace que tenga a la misma persona ve sus propias notas y etiquetas, no las tuyas.
Para la ficha completa de la persona (datos, experiencia, contactos) usa GET /talent/pool/{profileId}. Todas las listas de esta página paginan con page y pageSize y devuelven { rows, total, page, pageSize } (ver paginación).
Notas
GET /profiles/{profileId}/notes
/profiles/{profileId}/notesDevuelve las notas que escribieron los miembros de tu workspace sobre la persona, de la más nueva a la más vieja. Una persona sin notas, o que no está en tu pool, devuelve una lista vacía.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
curl "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/notes?page=1&pageSize=20" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "b2d4e6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
"profileId": "3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81",
"authorId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"authorName": "Lucía Méndez",
"body": "<p>Disponible desde marzo. Prefiere modalidad híbrida.</p>",
"createdAt": "2026-10-14T15:42:10.000Z",
"updatedAt": null
}
],
"total": 1,
"page": 1,
"pageSize": 20
}body es texto enriquecido en HTML saneado: el texto plano que mandes al crear la nota vuelve envuelto en párrafos.
POST /profiles/{profileId}/notes
/profiles/{profileId}/notesCrea una nota sobre la persona, firmada por quien es dueño de la API key. La persona tiene que estar en el pool de tu workspace. Devuelve la nota creada. Acepta Idempotency-Key (ver idempotencia).
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| body | string | Sí | El texto de la nota, de 1 a 20000 caracteres. Acepta texto plano o HTML; el HTML se sanea. |
curl -X POST "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/notes" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 5d1f0c7e-2b9a-4c6d-8e3f-a1b2c3d4e5f6" \
-d '{ "body": "Disponible desde marzo. Prefiere modalidad híbrida." }'Respuesta
{
"id": "b2d4e6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
"profileId": "3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81",
"authorId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"authorName": "Lucía Méndez",
"body": "<p>Disponible desde marzo. Prefiere modalidad híbrida.</p>",
"createdAt": "2026-10-22T13:05:44.000Z",
"updatedAt": null
}Errores
NOT_FOUND(404): la persona no está en el pool de tu workspace.INVALID(400): el cuerpo está vacío o queda vacío después de sanear el HTML.FORBIDDEN(403): tu rol no puede escribir en el workspace.
Para editar una nota usa PATCH /talent/notes/{noteId} o la acción update_note. La acción create_note hace lo mismo que esta ruta.
Etiquetas
GET /profiles/{profileId}/tags
/profiles/{profileId}/tagsDevuelve las etiquetas que la persona tiene en tu workspace, ordenadas por nombre. Las etiquetas archivadas no aparecen.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
curl "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/tags" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{ "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f", "name": "inglés nativo", "color": null },
{ "id": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f6a", "name": "senior", "color": "blue" }
],
"total": 2,
"page": 1,
"pageSize": 50
}POST /profiles/{profileId}/tags
/profiles/{profileId}/tagsLe pone una etiqueta a la persona, por nombre. Si el workspace ya tiene una etiqueta con ese nombre (sin distinguir mayúsculas), la reutiliza; si estaba archivada, la restaura; si no existe, la crea. Si la persona ya la tenía, no es un error: devuelve la etiqueta igual.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre de la etiqueta, de 1 a 60 caracteres. |
| color | string | null | Opcional | Color, hasta 20 caracteres. Sólo se usa si la etiqueta se crea en esta llamada. |
curl -X POST "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/tags" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "senior" }'Respuesta
{ "id": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f6a", "name": "senior", "color": "blue" }Errores
NOT_FOUND(404): la persona no existe o no es visible para tu workspace.FORBIDDEN(403): tu rol no puede escribir en el workspace.
Para etiquetar a varias personas a la vez usa POST /talent/pool/tags o la acción add_profile_tag.
DELETE /profiles/{profileId}/tags/{tagId}
/profiles/{profileId}/tags/{tagId}Le saca la etiqueta a la persona. La etiqueta sigue existiendo en el workspace y las demás personas la conservan. Contesta 204 sin cuerpo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
| tagId | uuid | Sí | La etiqueta a sacar. |
curl -X DELETE "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/tags/d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f6a" \
-H "Authorization: Bearer $RECLEE_API_KEY"Errores
NOT_FOUND(404): la persona no tenía esa etiqueta en tu workspace.FORBIDDEN(403): tu rol no puede escribir en el workspace.
La acción equivalente, por nombre y para varias personas, es remove_profile_tag.
Listas
GET /profiles/{profileId}/bookmarks
/profiles/{profileId}/bookmarksDevuelve las listas de tu workspace en las que está la persona. Las listas privadas de otros miembros no aparecen.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
curl "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/bookmarks" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{ "id": "e3f4a5b6-c7d8-4e9f-8a0b-1c2d3e4f5a6b", "name": "Backend LATAM", "isPrivate": false }
],
"total": 1,
"page": 1,
"pageSize": 50
}Para manejar listas mira Listas en la referencia de talento y las acciones de listas.
Historial
GET /profiles/{profileId}/events
/profiles/{profileId}/eventsDevuelve lo que le pasó a la persona en tu workspace, del más viejo al más nuevo: cuándo entró al pool, etiquetas y listas, búsquedas de contacto, actualizaciones del perfil, CVs y adjuntos, no contactar, fusiones. Si pasas el id de una persona que se fusionó con otra, devuelve el historial de la persona que quedó.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Cada evento trae:
| Campo | Qué es |
|---|---|
kind | Qué pasó: PROFILE_ADDED, PROFILE_CREATED, PROFILE_EDITED, PROFILE_REFRESHED, HANDLE_REASSIGNED, TAG_ADDED, TAG_REMOVED, BOOKMARK_ADDED, BOOKMARK_REMOVED, CONTACT_LOOKED_UP, CONTACT_EDITED, DO_NOT_CONTACT_SET, DO_NOT_CONTACT_LIFTED, CV_UPLOADED, ATTACHMENT_ADDED, ATTACHMENT_REMOVED, PROFILES_MERGED, MERGE_REJECTED, REMOVED_FROM_POOL. |
actorKind | Quién lo hizo: MEMBER, AGENT, CANDIDATE, AUTOMATION o SYSTEM. |
actorName | Nombre del miembro cuando actorKind es MEMBER; si no, null. |
label | El nombre de la etiqueta, lista, CV o archivo, el motivo de no contactar, el handle o la fuente de la entrada, según el kind. |
origin | Sólo en PROFILE_ADDED: sourcing, manualEntry, cvUpload o careerPage. |
channel | En eventos de contacto: WORK_EMAIL, PERSONAL_EMAIL o PHONE. |
found | Sólo en CONTACT_LOOKED_UP: si la búsqueda encontró el dato. |
action | Sólo en CONTACT_EDITED: added o removed. |
firstTime | Sólo en PROFILE_REFRESHED: si fue el primer enriquecimiento pago de la persona en tu workspace. |
version | La versión del perfil, en los eventos que la tienen. |
Los campos que no aplican al kind vienen en null.
curl "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/events?pageSize=100" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "f4a5b6c7-d8e9-4f0a-9b1c-2d3e4f5a6b7c",
"kind": "PROFILE_ADDED",
"occurredAt": "2026-09-02T10:11:00.000Z",
"actorKind": "MEMBER",
"actorName": "Lucía Méndez",
"label": null,
"origin": "sourcing",
"channel": null,
"found": null,
"action": null,
"firstTime": null,
"version": 1
},
{
"id": "a5b6c7d8-e9f0-4a1b-8c2d-3e4f5a6b7c8d",
"kind": "CONTACT_LOOKED_UP",
"occurredAt": "2026-09-03T16:20:00.000Z",
"actorKind": "MEMBER",
"actorName": "Lucía Méndez",
"label": null,
"origin": null,
"channel": "WORK_EMAIL",
"found": true,
"action": null,
"firstTime": null,
"version": null
}
],
"total": 7,
"page": 1,
"pageSize": 100
}Errores
INVALID(400):profileIdno es un UUID.
GET /profiles/{profileId}/milestones
/profiles/{profileId}/milestonesDevuelve los hitos de todas las postulaciones que la persona tuvo en tu workspace, del más viejo al más nuevo: cuándo la agregaron a una vacante o se postuló, si pasó a la shortlist, si la descalificaron o la restauraron, si la contrataron y si se activó la garantía. Cada hito dice además dónde está hoy esa postulación. Como events, sigue a la persona que quedó después de una fusión.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
| Campo | Qué es |
|---|---|
kind | ADDED (la agregó un miembro), APPLIED (se postuló desde el sitio de empleos), SHORTLISTED, DISQUALIFIED, RESTORED, HIRED o GUARANTEE_ACTIVATED. |
applicationId, jobPostId, jobPostTitle | La postulación y su vacante. |
actorName | El miembro que lo hizo, o null si fue automático. |
disqualifiedReason | Sólo en DISQUALIFIED: FAILED_CRITERION, INSUFFICIENT_DATA, NOT_RESPONSIVE, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, FAILED_SCREENING, WITHDREW u OTHER. |
currentStageName | La etapa actual de la postulación. Es null cuando la etapa conserva el nombre por defecto de la plantilla del pipeline. |
status | El estado actual de la postulación: QUALIFIED, DISQUALIFIED o WITHDRAWN. |
curl "https://app.reclee.com/api/v1/profiles/3f6c2a9e-8b41-4d7a-9c15-2e7b0a4d6f81/milestones" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "b6c7d8e9-f0a1-4b2c-9d3e-4f5a6b7c8d9e",
"kind": "ADDED",
"applicationId": "c7d8e9f0-a1b2-4c3d-8e4f-5a6b7c8d9e0f",
"jobPostId": "d8e9f0a1-b2c3-4d4e-9f5a-6b7c8d9e0f1a",
"jobPostTitle": "Backend Engineer Sr. — Northwind Logistics",
"occurredAt": "2026-09-05T12:00:00.000Z",
"actorName": "Lucía Méndez",
"disqualifiedReason": null,
"currentStageName": "Entrevista con cliente",
"status": "QUALIFIED"
}
],
"total": 3,
"page": 1,
"pageSize": 50
}Errores
INVALID(400):profileIdno es un UUID.
Para el detalle de cada postulación mira la referencia del ATS.