Reclee

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

GET/profiles/{profileId}/notes

Devuelve 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Parámetros de query

CampoTipoRequeridoDescripción
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas 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

POST/profiles/{profileId}/notes

Crea 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Body

CampoTipoRequeridoDescripción
bodystringSí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

GET/profiles/{profileId}/tags

Devuelve las etiquetas que la persona tiene en tu workspace, ordenadas por nombre. Las etiquetas archivadas no aparecen.

Parámetros de ruta

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Parámetros de query

CampoTipoRequeridoDescripción
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas 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

POST/profiles/{profileId}/tags

Le 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Body

CampoTipoRequeridoDescripción
namestringSíNombre de la etiqueta, de 1 a 60 caracteres.
colorstring | nullOpcionalColor, 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}

DELETE/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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.
tagIduuidSí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

GET/profiles/{profileId}/bookmarks

Devuelve las listas de tu workspace en las que está la persona. Las listas privadas de otros miembros no aparecen.

Parámetros de ruta

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Parámetros de query

CampoTipoRequeridoDescripción
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas 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

GET/profiles/{profileId}/events

Devuelve 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Parámetros de query

CampoTipoRequeridoDescripción
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas por página, hasta 200. Default 50.

Cada evento trae:

CampoQué es
kindQué 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.
actorKindQuién lo hizo: MEMBER, AGENT, CANDIDATE, AUTOMATION o SYSTEM.
actorNameNombre del miembro cuando actorKind es MEMBER; si no, null.
labelEl 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.
originSólo en PROFILE_ADDED: sourcing, manualEntry, cvUpload o careerPage.
channelEn eventos de contacto: WORK_EMAIL, PERSONAL_EMAIL o PHONE.
foundSólo en CONTACT_LOOKED_UP: si la búsqueda encontró el dato.
actionSólo en CONTACT_EDITED: added o removed.
firstTimeSólo en PROFILE_REFRESHED: si fue el primer enriquecimiento pago de la persona en tu workspace.
versionLa 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): profileId no es un UUID.

GET /profiles/{profileId}/milestones

GET/profiles/{profileId}/milestones

Devuelve 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Parámetros de query

CampoTipoRequeridoDescripción
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas por página, hasta 200. Default 50.
CampoQué es
kindADDED (la agregó un miembro), APPLIED (se postuló desde el sitio de empleos), SHORTLISTED, DISQUALIFIED, RESTORED, HIRED o GUARANTEE_ACTIVATED.
applicationId, jobPostId, jobPostTitleLa postulación y su vacante.
actorNameEl miembro que lo hizo, o null si fue automático.
disqualifiedReasonSó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.
currentStageNameLa etapa actual de la postulación. Es null cuando la etapa conserva el nombre por defecto de la plantilla del pipeline.
statusEl 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): profileId no es un UUID.

Para el detalle de cada postulación mira la referencia del ATS.

En esta página