Talento
El pool de talento de tu workspace por API — personas, contactos, CVs, listas, búsquedas, etiquetas y notas.
El área de talento es el pool de tu workspace: todas las personas que guardaste, con sus datos, contactos, CVs y adjuntos, más las herramientas para encontrarlas y ordenarlas (listas, búsquedas, etiquetas, notas, duplicados). Todo lo que devuelven estas rutas está acotado al workspace de tu API key.
Algunas rutas consultan a un proveedor externo de datos y consumen créditos: revelar contactos, enriquecer perfiles, agregar personas desde LinkedIn y las búsquedas de talento. Cada sección dice cuánto gasta y, cuando existe, qué ruta usar para estimarlo antes. Lo que está en una persona (notas, etiquetas, listas, historial) se lee en la referencia de perfiles, y las escrituras de negocio también están como acciones en pool de talento, búsqueda de talento y listas.
Pool
El pool de talento son todas las personas que tu workspace guarda. Ninguna ruta recibe un workspace: siempre es el de la persona dueña de la API key. Una persona que no está en tu pool responde 404, nunca 403.
GET /talent/pool
/talent/poolLista las personas del pool, filtradas y ordenadas. Cada fila trae el puesto actual, los años de experiencia, las etiquetas, los canales de contacto conocidos y la marca de «no contactar».
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, de 1 a 200. Default 50. |
| sort | enum | Opcional | Orden: 'added' (última incorporación primero, default), 'updated' (último perfil actualizado) o 'name'. |
| search | string | Opcional | Texto libre, hasta 200 caracteres. Cada palabra tiene que aparecer en algún lado. |
| titles | string[] (separado por comas) | Opcional | Puestos (coincidencia parcial). Hasta 20 valores. |
| companies | string[] (separado por comas) | Opcional | Empresas (coincidencia parcial). Hasta 20 valores. |
| locations | string[] (separado por comas) | Opcional | Ubicaciones (coincidencia parcial). Hasta 20 valores. |
| skills | string[] (separado por comas) | Opcional | Skills. Hasta 20. Por default la persona tiene que tenerlas todas (ALL). |
| languages | string[] (separado por comas) | Opcional | Idiomas. Hasta 20. Por default ALL. |
| institutions | string[] (separado por comas) | Opcional | Instituciones educativas. Hasta 20. |
| certifications | string[] (separado por comas) | Opcional | Certificaciones. Hasta 20. |
| tags | string[] (separado por comas) | Opcional | Nombres de etiquetas. Hasta 20. |
| bookmarkIds | uuid[] (separado por comas) | Opcional | Limita a las personas de estas listas. Hasta 50. |
| jobPostIds | uuid[] (separado por comas) | Opcional | Personas que pasaron por estas vacantes. Hasta 50. |
| importJobIds | uuid[] (separado por comas) | Opcional | Personas que archivó una carga de CVs. Hasta 20. |
| experienceMin | integer | Opcional | Años de experiencia mínimos, de 0 a 60. |
| experienceMax | integer | Opcional | Años de experiencia máximos, de 0 a 60. |
| freshness | enum | Opcional | Antigüedad del perfil público: 'FRESH' (menos de 90 días), 'AGING' (hasta un año) o 'STALE' (más de un año). |
| contactStatus | enum | Opcional | 'doNotContact', 'reachable' o 'unreachable'. |
| doNotContact | boolean | Opcional | 'true' o 'false': con o sin la marca de no contactar. |
| relationStatuses | enum[] (separado por comas) | Opcional | Relación con tus vacantes: 'available', 'inProcess', 'placed', 'discarded'. También existe relationStatus con un solo valor. |
| origins | enum[] (separado por comas) | Opcional | Cómo entró al pool: 'SOURCED', 'MANUAL', 'CV', 'APPLIED'. También existe origin con un solo valor. |
| profileKinds | enum[] (separado por comas) | Opcional | Qué perfil tiene: 'public' (el de LinkedIn), 'own' (el que escribió tu workspace) o 'both'. |
| addedFrom | string (ISO 8601) | Opcional | Incorporados desde este instante (inclusive). Con zona horaria. |
| addedTo | string (ISO 8601) | Opcional | Incorporados hasta este instante (inclusive). Con zona horaria. |
| <lista>Op | enum | Opcional | Operador de cada lista: titlesOp, companiesOp, locationsOp, skillsOp, languagesOp, institutionsOp, certificationsOp, tagsOp, jobPostIdsOp, originsOp, relationStatusesOp, profileKindsOp. Valores 'ANY' (al menos uno), 'ALL' (todos) o 'NONE' (ninguno). 'ALL' sólo vale donde una persona puede tener varios valores (skills, languages, institutions, certifications, tags, jobPostIds). |
Las listas viajan separadas por comas (skills=React,TypeScript). La query es estricta: un parámetro desconocido (por ejemplo skils) responde 400 INVALID en lugar de devolver todo el pool.
Pagina: devuelve { rows, total, page, pageSize } con page (desde 1) y pageSize (hasta 200, default 50). Ver paginación.
curl "https://app.reclee.com/api/v1/talent/pool?skills=React,TypeScript&locations=Madrid&sort=updated&pageSize=20" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14",
"firstName": "Lucía",
"lastName": "Ferrer",
"headline": "Frontend Engineer · React",
"currentTitle": "Senior Frontend Engineer",
"currentCompany": "Nubeloop",
"location": "Madrid, España",
"yearsOfExperience": 8,
"tags": ["react", "remoto"],
"channels": [
{ "type": "LINKEDIN", "value": "https://www.linkedin.com/in/luciaferrer", "source": null },
{ "type": "EMAIL_WORK", "value": "lucia@nubeloop.io", "source": "MANUAL" }
],
"avatarUrl": null,
"hasPublicProfile": true,
"hasOwnProfile": false,
"publicUpdatedAt": "2026-08-02T10:14:00Z",
"ownUpdatedAt": null,
"updatedAt": "2026-08-02T10:14:00Z",
"freshness": "FRESH",
"addedAt": "2026-07-28T16:40:12Z",
"doNotContactAt": null,
"doNotContactNote": null
}
],
"total": 134,
"page": 1,
"pageSize": 20
}avatarUrl es un link firmado que vence en una hora. yearsOfExperience es null cuando no se conoce ninguna fecha de inicio (no es lo mismo que 0).
Errores
INVALID(400): un filtro con un valor inválido, oALLen una lista de un solo valor.
DELETE /talent/pool
/talent/poolUna API key no borra personas del pool. Contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "remove_from_pool" }]. Para sacar personas del pool usa POST /actions/remove_from_pool, que las archiva sin borrar nada de lo que tu workspace escribió sobre ellas.
POST /talent/pool/details
/talent/pool/detailsLee la ficha completa de varias personas en una llamada. Es un POST porque los ids viajan en el body; no escribe nada. Quien no está en tu pool queda fuera de la respuesta, sin error.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 20 ids de persona. |
curl https://app.reclee.com/api/v1/talent/pool/details \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"] }'Respuesta (extracto)
Un array de { profileId, detail }, donde detail tiene la misma forma que GET /talent/pool/{profileId}.
[
{
"profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14",
"detail": { "profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "talent": { "firstName": "Lucía" }, "applications": [] }
}
]GET /talent/pool/facets
/talent/pool/facetsEl vocabulario del pool: los puestos, empresas, ubicaciones, skills, idiomas, instituciones y certificaciones que tienen sus personas, cada lista ordenada por cuántas personas lo llevan y con un máximo de 200 valores. Sirve para armar los filtros de GET /talent/pool; un valor que no aparece aquí igual filtra.
curl https://app.reclee.com/api/v1/talent/pool/facets \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"titles": ["Backend Engineer", "Product Designer"],
"companies": ["Nubeloop", "Tramalia"],
"locations": ["Madrid, España", "Ciudad de México"],
"skills": ["TypeScript", "React", "Go"],
"languages": ["Inglés", "Español"],
"institutions": ["Universidad de Valencia"],
"certifications": ["AWS Solutions Architect"]
}GET /talent/pool/export
/talent/pool/exportDescarga una selección del pool como CSV (UTF-8 con BOM, Content-Disposition: attachment, nombre talent-pool-AAAA-MM-DD.csv). Trae la fila de la grilla más estudios, skills e idiomas, y siempre las columnas de «no contactar». Los encabezados y fechas salen en el idioma y la zona horaria de la request.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] (separado por comas) | Sí | Las personas a exportar, hasta 500. Sin este parámetro responde 400: no existe exportar todo el pool sin selección. |
curl "https://app.reclee.com/api/v1/talent/pool/export?profileIds=3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14,9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-o talent-pool.csvColumnas, en orden: nombre, apellido, titular, puesto actual, empresa actual, ubicación, años de experiencia, etiquetas, LinkedIn, email laboral, email personal, teléfono, estudios, skills, idiomas, frescura, actualización del perfil público, actualización del perfil propio, fecha de incorporación, no contactar y motivo.
Errores
INVALID(400): faltaprofileIds, o trae más de 500 ids o un id que no es UUID.NOT_FOUND(404): ninguno de los ids está en tu pool.
GET /talent/pool/screen
/talent/pool/screenLo que la pantalla del pool lee al abrir, en una sola llamada: las listas del workspace (bookmarks), las vacantes a las que se puede sumar a alguien (jobPosts), el vocabulario (facets) y una carga de CVs en curso (runningImport). Cada parte trae su propio { ok, data } o { ok, error }, así que un 200 puede contener una parte fallida. Cada parte tiene además su propia ruta; para integraciones conviene usar esas.
curl https://app.reclee.com/api/v1/talent/pool/screen \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"bookmarks": { "ok": true, "data": [] },
"jobPosts": { "ok": true, "data": [] },
"facets": { "ok": true, "data": { "titles": ["Backend Engineer"], "companies": [], "locations": [], "skills": [], "languages": [], "institutions": [], "certifications": [] } },
"runningImport": { "ok": true, "data": null }
}Una persona del pool
GET /talent/pool/{profileId}
/talent/pool/{profileId}La ficha completa de una persona: la fila del pool (talent), las versiones del perfil que escribió tu workspace (ownProfiles), el perfil público de LinkedIn guardado (publicProfile, null si nunca se enriqueció), las vacantes por las que pasó (applications), sus CVs, sus contactos con id, cómo entró al pool (provenance) y la marca de no contactar.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
curl https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14 \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14",
"hasProviderKey": true,
"talent": { "profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "firstName": "Lucía", "lastName": "Ferrer", "currentTitle": "Senior Frontend Engineer", "channels": [] },
"ownProfiles": [],
"ownSeed": null,
"publicProfile": {
"headline": "Frontend Engineer · React",
"summary": null,
"location": "Madrid, España",
"profileUrl": "https://www.linkedin.com/in/luciaferrer",
"fetchedAt": "2026-08-02T10:14:00Z",
"experience": [
{ "title": "Senior Frontend Engineer", "organizationName": "Nubeloop", "logoUrl": null, "employmentType": null, "location": "Madrid", "description": null, "isCurrent": true, "startYear": 2022, "startMonth": 3, "endYear": null, "endMonth": null }
],
"education": [],
"skills": ["React", "TypeScript"],
"languages": [{ "name": "Inglés", "proficiency": "PROFESSIONAL_WORKING" }],
"certifications": []
},
"applications": [
{
"applicationId": "c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
"jobPostId": "6e2b9c4d-1a7f-4e3b-8d2c-5f9a0b1c2d3e",
"jobPostTitle": "Frontend Lead",
"clientName": "Tramalia",
"entryPoint": "SOURCED",
"longlistName": null,
"stageReached": "INTERVIEW",
"matchScorePct": 82,
"status": "QUALIFIED",
"disqualifiedReason": null,
"disqualifiedComment": null,
"lastActivityAt": "2026-09-14T12:00:00Z"
}
],
"cvs": [
{ "id": "8e9f0a1b-2c3d-4e5f-8a6b-7c8d9e0f1a2b", "version": 1, "fileName": "lucia-ferrer.pdf", "format": "pdf", "byteSize": 182340, "uploadedAt": "2026-07-28T16:40:12Z", "uploadedByName": "Marta Ruiz" }
],
"provenance": { "origin": "SOURCED", "detail": null, "broughtByName": "Marta Ruiz", "broughtAt": "2026-07-28T16:40:12Z" },
"doNotContact": null,
"contacts": [
{ "id": "0f1e2d3c-4b5a-4c6d-9e8f-7a6b5c4d3e2f", "type": "EMAIL_WORK", "value": "lucia@nubeloop.io", "source": "MANUAL", "createdAt": "2026-07-29T09:00:00Z", "removable": true }
],
"publicLink": null
}Si la persona fue fusionada con otra, el id viejo resuelve a quien quedó.
Errores
NOT_FOUND(404): la persona no está en tu pool.
Para escribir: update_profile, add_profile_contact.
DELETE /talent/pool/{profileId}
/talent/pool/{profileId}Contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "remove_from_pool" }]. Usa POST /actions/remove_from_pool con { "profileIds": ["…"] }.
GET /talent/pool/{profileId}/profile
/talent/pool/{profileId}/profileLa persona sin datos de contacto, sin archivos ni links firmados: la fila (sin channels, avatarUrl ni el motivo de no contactar), sus dos perfiles y las vacantes por las que pasó. Es la lectura pensada para un agente o un sistema que no necesita contactar a nadie.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
curl https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/profile \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14",
"hasProviderKey": true,
"talent": {
"profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14",
"firstName": "Lucía",
"lastName": "Ferrer",
"headline": "Frontend Engineer · React",
"currentTitle": "Senior Frontend Engineer",
"currentCompany": "Nubeloop",
"location": "Madrid, España",
"yearsOfExperience": 8,
"tags": ["react"],
"hasPublicProfile": true,
"hasOwnProfile": false,
"freshness": "FRESH",
"addedAt": "2026-07-28T16:40:12Z",
"doNotContactAt": null
},
"ownProfiles": [],
"ownSeed": null,
"publicProfile": { "headline": "Frontend Engineer · React", "skills": ["React", "TypeScript"] },
"applications": []
}Errores
NOT_FOUND(404): la persona no está en tu pool.
GET /talent/pool/{profileId}/screen
/talent/pool/{profileId}/screenLo que el panel de la persona lee al abrirse, en una llamada: la ficha (detail), las notas, las etiquetas, el vocabulario de etiquetas, las listas donde está y el estado de cada canal de contacto (contactStates). Cada parte trae su propio { ok, data } o { ok, error }. Cada parte tiene su ruta propia; para integraciones conviene usar esas.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
curl https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/screen \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"detail": { "ok": true, "data": { "profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14" } },
"notes": { "ok": true, "data": [] },
"tags": { "ok": true, "data": [{ "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "name": "react", "color": null }] },
"vocabulary": { "ok": true, "data": [] },
"bookmarks": { "ok": true, "data": [] },
"contactStates": { "ok": true, "data": [{ "type": "PHONE", "status": null, "value": null, "resolvedAt": null }] }
}GET /talent/pool/{profileId}/removal
/talent/pool/{profileId}/removalVista previa de qué se llevaría sacar a esta persona del pool desde la app, sin borrar nada: cuántos CVs, versiones propias, notas, etiquetas y listas, o las vacantes que lo impiden. Misma respuesta que POST /talent/pool/removal para una sola persona.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
curl https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/removal \
-H "Authorization: Bearer $RECLEE_API_KEY"GET /talent/pool/{profileId}/own
/talent/pool/{profileId}/ownTodas las versiones del perfil propio que tu workspace escribió de esta persona, de la más nueva a la más vieja. Es privado de tu workspace: otra agencia que tenga a la misma persona no lo ve.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Pagina: devuelve { rows, total, page, pageSize } con page (desde 1) y pageSize (hasta 200, default 50). Ver paginación.
curl "https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/own?page=1" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
"version": 2,
"source": "EDIT",
"headline": "Frontend Lead",
"location": "Madrid, España",
"summary": "Lidera equipos de 4 a 6 personas.",
"verifiedLanguages": "Inglés C1 (entrevista)",
"languages": ["Inglés", "Español"],
"links": ["https://github.com/luciaferrer"],
"profileLanguage": "es",
"candidateNotes": null,
"skills": ["React", "TypeScript"],
"positions": [
{ "title": "Senior Frontend Engineer", "organizationName": "Nubeloop", "isCurrent": true, "startYear": 2022, "startMonth": 3 }
],
"education": [],
"certifications": [],
"projects": [],
"cvId": null,
"createdAt": "2026-09-20T11:05:00Z",
"createdByName": "Marta Ruiz"
}
],
"total": 2,
"page": 1,
"pageSize": 50
}source es CV (leído de un CV), MANUAL o EDIT.
POST /talent/pool/{profileId}/own
/talent/pool/{profileId}/ownEscribe la siguiente versión del perfil propio, completa. Nada se sobrescribe: cada versión queda guardada y corregir es escribir la siguiente. Si la versión es idéntica a la que está arriba, no escribe nada y responde created: false. 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 |
|---|---|---|---|
| baseVersion | integer | null | Opcional | La versión sobre la que se escribió (null si no había ninguna). Si llegó otra versión en el medio responde PROFILE_CHANGED. Sin este campo se escribe sin control de concurrencia. |
| headline | string | Opcional | Hasta 200 caracteres. |
| location | string | Opcional | Hasta 200. Omitido conserva la de arriba. |
| summary | string | Opcional | Hasta 4000. |
| verifiedLanguages | string | Opcional | Idiomas que alguien de tu equipo verificó, texto libre, hasta 400. |
| languages | string[] | Opcional | Idiomas declarados, hasta 20. Omitido conserva los de arriba. |
| links | string[] (URL) | Opcional | LinkedIn, portfolio, GitHub, etc. Hasta 10. |
| profileLanguage | string | Opcional | Idioma del perfil en ISO 639-1 (por ejemplo 'es'). Cadena vacía lo borra. |
| candidateNotes | string | Opcional | Lo que dijo la persona sobre sí misma, hasta 4000. Cadena vacía lo borra. |
| skills | string[] | Opcional | Hasta 60. Default []. |
| positions | object[] | Opcional | Hasta 30 puestos: title y organizationName obligatorios; description, isCurrent, startYear, startMonth, endYear, endMonth opcionales. |
| education | object[] | Opcional | Hasta 20: schoolName obligatorio; degree, fieldOfStudy, startYear, endYear opcionales. |
| certifications | object[] | Opcional | Hasta 30: name obligatorio; authority, url, issuedYear opcionales. |
| projects | object[] | Opcional | Hasta 20: name obligatorio; description, url (http/https), isCurrent, startYear, startMonth, endYear, endMonth opcionales. |
curl https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/own \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 5b0f7a52-3c1e-4d7b-9a8e-2f6c1d0b3e94" \
-d '{
"baseVersion": 1,
"headline": "Frontend Lead",
"skills": ["React", "TypeScript"],
"positions": [
{ "title": "Senior Frontend Engineer", "organizationName": "Nubeloop", "isCurrent": true, "startYear": 2022 }
]
}'Respuesta (extracto)
{
"created": true,
"profile": { "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e", "version": 2, "source": "EDIT", "headline": "Frontend Lead" }
}Errores
NOT_FOUND(404): la persona no está en tu pool.PROFILE_CHANGED(409): otra versión llegó después debaseVersion. Vuelve a leer conGETy vuelve a escribir.
Para escribir con la acción equivalente: update_profile.
PATCH /talent/pool/{profileId}/own
/talent/pool/{profileId}/ownEscribe la siguiente versión como un cambio sobre la que está arriba. Los textos con null se borran, las listas reemplazan su lista, y la carrera se toca sólo agregando entradas o quitándolas por índice. Responde la versión nueva.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| baseVersion | integer | null | Sí | La versión que está arriba (null si tu workspace todavía no escribió ninguna). |
| headline | string | null | Opcional | Hasta 200. null lo borra. |
| location | string | null | Opcional | Hasta 200. null lo borra. |
| summary | string | null | Opcional | Hasta 4000. null lo borra. |
| verifiedLanguages | string | null | Opcional | Hasta 400. null lo borra. |
| languages | string[] | Opcional | Reemplaza la lista. Hasta 20. |
| skills | string[] | Opcional | Reemplaza la lista. Hasta 60. |
| addPositions / removePositions | object[] / integer[] | Opcional | Puestos a agregar (misma forma que en POST) e índices (desde 0) a quitar. |
| addEducation / removeEducation | object[] / integer[] | Opcional | Estudios a agregar e índices a quitar. |
| addCertifications / removeCertifications | object[] / integer[] | Opcional | Certificaciones a agregar e índices a quitar. |
| addProjects / removeProjects | object[] / integer[] | Opcional | Proyectos a agregar e índices a quitar. |
Hace falta al menos un campo además de baseVersion.
curl -X PATCH https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/own \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "baseVersion": 2, "location": "Valencia, España", "removePositions": [1] }'Respuesta (extracto)
{ "id": "4d5e6f7a-8b9c-4d0e-8f1a-2b3c4d5e6f7a", "version": 3, "source": "EDIT", "location": "Valencia, España" }Errores
NOT_FOUND(404): la persona no está en tu pool.PROFILE_CHANGED(409):baseVersionya no es la versión de arriba.CAREER_ENTRY_NOT_FOUND(404): un índice deremove…no existe.CAREER_TOO_LONG(400): el resultado supera el máximo de la lista.NOTHING_TO_CHANGE(409): el cambio deja el perfil igual.
POST /talent/pool/{profileId}/linkedin
/talent/pool/{profileId}/linkedinLe asigna un LinkedIn a alguien que tu workspace ya tiene (por ejemplo, alguien que entró por CV o a mano) y trae su perfil público. Acepta Idempotency-Key (ver idempotencia).
Consume créditos
Traer el perfil cuesta un enriquecimiento. La respuesta dice cuánto se consumió en credits (0 cuando no se consultó nada, por ejemplo con already, hasOther o taken). Requiere un asiento (rol OWNER o RECRUITER).
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| handle | string | Sí | La URL de LinkedIn o el handle, hasta 300 caracteres. |
curl https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/linkedin \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 0c2d9f6e-7b1a-4e3c-8d5f-6a9b0c1d2e3f" \
-d '{ "handle": "https://www.linkedin.com/in/luciaferrer" }'Respuesta
{
"outcome": "linked",
"handle": "luciaferrer",
"credits": 1,
"profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14",
"duplicateOf": null
}outcome puede ser:
| Valor | Qué pasó |
|---|---|
linked | Se asignó y se trajo el perfil. |
merged | El handle era de un perfil fuera de tu pool: tu persona se unió a ese perfil. profileId dice quién queda. |
notFound | Se asignó, pero no hay perfil público con ese handle. El handle queda. |
already | La persona ya tenía ese mismo handle. |
hasOther | La persona tiene otro handle; cambiarlo es una corrección, no un link. |
taken | Otra persona de tu pool ya tiene ese handle (duplicateOf). No se fusiona: usa fusiones. |
Errores
INVALID(400): el texto no contiene un handle de LinkedIn.NOT_FOUND(404): la persona no está en tu pool.SEAT_REQUIRED(403): tu rol no tiene asiento.NO_CREDITS(402) y otros bloqueos de facturación: no hay saldo para el enriquecimiento.
PUT /talent/pool/{profileId}/do-not-contact
/talent/pool/{profileId}/do-not-contactMarca a una persona como «no contactar» para tu workspace (no afecta a otros workspaces). El motivo es obligatorio. Si ya estaba marcada, conserva la fecha y el motivo originales. Responde true. Esta ruta sólo marca: levantar la marca lo hace una persona desde la app, y no existe DELETE.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| note | string | Sí | Por qué, de 1 a 500 caracteres. |
curl -X PUT https://app.reclee.com/api/v1/talent/pool/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14/do-not-contact \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "note": "Pidió por mail no ser contactada hasta 2027." }'Respuesta
trueErrores
NOT_FOUND(404): la persona no está en tu pool.
Para escribir con la acción equivalente: set_profile_do_not_contact.
Agregar personas
POST /talent/pool/save
/talent/pool/saveGuarda en el pool a personas que mostró una búsqueda de talento. Una búsqueda sólo muestra personas: entran al pool cuando se guardan aquí, se agregan a una lista o a una vacante. Guardar dos veces no es un error.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 500 ids. |
curl https://app.reclee.com/api/v1/talent/pool/save \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"] }'Respuesta
{ "saved": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14"], "already": 1 }saved son quienes entraron ahora; already cuenta los que ya estaban (o que nunca se mostraron en tu workspace).
Para escribir con la acción equivalente: save_to_pool.
POST /talent/pool/manual
/talent/pool/manualAgrega a alguien a mano: un nombre y al menos un identificador (email o URL de LinkedIn). Nunca consume créditos: no se consulta a ningún proveedor. Si el identificador ya pertenece a alguien de tu pool, no crea a nadie y responde created: false con el id existente. Acepta Idempotency-Key (ver idempotencia).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre completo, hasta 200 caracteres. |
| string (email) | Opcional | Hasta 320. Obligatorio si no hay linkedin. | |
| string | Opcional | URL de un perfil personal de LinkedIn, hasta 300. Obligatorio si no hay email. | |
| phone | string | Opcional | Hasta 40. |
| headline | string | Opcional | Hasta 200. |
| title | string | Opcional | Puesto actual, hasta 200. Obligatorio si mandas company. |
| company | string | Opcional | Empresa actual, hasta 200. |
| location | string | Opcional | Hasta 200. |
| summary | string | Opcional | Hasta 4000. |
| skills | string[] | Opcional | Hasta 60, cada una hasta 80 caracteres. |
Los datos de perfil (headline, title, company, location, summary, skills) quedan en el perfil propio de tu workspace.
curl https://app.reclee.com/api/v1/talent/pool/manual \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 4a7e2b1c-9d3f-4c8a-b5e6-0f1a2b3c4d5e" \
-d '{
"name": "Diego Salvatierra",
"email": "diego.salvatierra@example.com",
"title": "Data Engineer",
"company": "Tramalia",
"location": "Montevideo, Uruguay"
}'Respuesta
{ "profileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d", "created": true }Errores
INVALID(400): falta el email y el LinkedIn, o haycompanysintitle.LINKEDIN_NOT_A_PERSON(400): la URL de LinkedIn no es de una persona (por ejemplo, una página de empresa o un post).
Para escribir con la acción equivalente: create_profile.
GET /talent/pool/manual/duplicate
/talent/pool/manual/duplicateAntes de cargar a alguien a mano, dice quién de tu pool ya tiene ese email o ese LinkedIn. Aplica la misma regla que POST /talent/pool/manual. Responde la persona o null.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| string | Opcional | Email a buscar, hasta 320. | |
| string | Opcional | URL o handle de LinkedIn, hasta 300. |
curl "https://app.reclee.com/api/v1/talent/pool/manual/duplicate?email=diego.salvatierra@example.com" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{ "profileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d", "name": "Diego Salvatierra" }POST /talent/pool/linkedin
/talent/pool/linkedinTrae personas al pool desde LinkedIn, por URL o handle. Las líneas se mandan tal cual (el servidor extrae el handle). Quien tu workspace ya pagó se responde desde el pool sin consultar al proveedor. Acepta Idempotency-Key (ver idempotencia).
Consume créditos
Cada handle que tu pool todavía no tiene enriquecido cuesta un enriquecimiento, se encuentre o no. Con refresh: true también se vuelve a pagar a quien ya estaba. La respuesta trae los créditos consumidos en credits. Para estimar antes, cuenta cuántos handles no tienes: GET /talent/pool/manual/duplicate?linkedin=… responde si alguien de tu pool ya tiene ese LinkedIn. Requiere un asiento (rol OWNER o RECRUITER).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| urls | string[] | Sí | Entre 1 y 1000 líneas, cada una una URL o handle de LinkedIn de hasta 300 caracteres. |
| refresh | boolean | Opcional | Volver a traer el perfil de quien ya estaba pagado. Default false. |
curl https://app.reclee.com/api/v1/talent/pool/linkedin \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 8f3e1d2c-6b5a-4c9d-8e7f-1a2b3c4d5e6f" \
-d '{ "urls": ["https://www.linkedin.com/in/luciaferrer", "linkedin.com/in/diegosalvatierra", "no es un link"] }'Respuesta
{
"credits": 1,
"outcomes": [
{ "raw": "https://www.linkedin.com/in/luciaferrer", "handle": "luciaferrer", "kind": "exists", "profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "name": "Lucía Ferrer", "doNotContact": false, "twin": null },
{ "raw": "linkedin.com/in/diegosalvatierra", "handle": "diegosalvatierra", "kind": "added", "profileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d", "name": "Diego Salvatierra", "doNotContact": false, "twin": null },
{ "raw": "no es un link", "handle": null, "kind": "invalid", "profileId": null, "name": null, "doNotContact": false, "twin": null }
]
}kind: added (nuevo y pagado), refreshed (ya pagado y vuelto a traer), exists (ya estaba, sin costo), stale (ya estaba, pero el perfil tiene más de 90 días; mandalo con refresh: true para actualizarlo), invalid (la línea no tiene handle, no se consulta) o failed (el proveedor no lo trajo). twin señala a alguien de tu pool sin LinkedIn y con el mismo nombre, para que lo vincules con POST /talent/pool/{profileId}/linkedin.
Errores
INVALID(400): más de 1000 handles distintos.SEAT_REQUIRED(403): tu rol no tiene asiento.NO_CREDITS(402) y otros bloqueos de facturación: no hay saldo para lo que hay que pagar.
Para escribir con la acción equivalente: enrich_profile.
POST /talent/pool/sheet/columns
/talent/pool/sheet/columnsLee los encabezados y las filas de una planilla (CSV o XLSX) sin importar nada, para que puedas decidir qué columna es qué antes de POST /talent/pool/sheet. No usa IA ni consume nada. Se manda como multipart/form-data con el campo file.
Body (multipart)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| file | file | Sí | La planilla, hasta 4 MB. Se leen hasta 300 filas. |
curl https://app.reclee.com/api/v1/talent/pool/sheet/columns \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-F "file=@candidatos.xlsx"Respuesta (extracto)
{
"headers": ["Nombre", "Email", "LinkedIn", "Puesto 1", "Empresa 1"],
"rows": [["Diego Salvatierra", "diego.salvatierra@example.com", "", "Data Engineer", "Tramalia"]],
"lines": [2],
"total": 1,
"truncated": false
}lines es el número de línea de cada fila en el archivo (el encabezado es la 1). truncated es true cuando el archivo tenía más de 300 filas.
Errores
TOO_LARGE(413): el archivo pesa más de 4 MB.NOT_A_SHEET,OLD_XLS,EMPTY,UNREADABLE(400): no es una planilla, es un.xlsanterior a 2007, está vacía o no se pudo leer.
POST /talent/pool/sheet
/talent/pool/sheetImporta una planilla ya mapeada: cada fila se vuelve una persona del pool. El archivo se vuelve a mandar (no se guarda entre las dos llamadas). Cada fila se responde por separado: una que falla no frena a las demás. No usa IA y no consume créditos. Se manda como multipart/form-data; los campos que no son el archivo van como strings JSON.
Body (multipart)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| file | file | Sí | La planilla, hasta 4 MB. Se importan hasta 300 filas. |
| mappings | string (JSON) | Sí | Array de { columnIndex, field }. field: fullName, firstName, lastName, headline, summary, email, personalEmail, phone, linkedin, location, country, region, city. Tiene que haber un nombre (fullName o firstName) y un identificador (email, personalEmail o linkedin). |
| blocks | string (JSON) | Opcional | Array de { kind, index, field, columnIndex } para bloques repetibles. kind: 'experience' (title y organizationName obligatorios; startYear, endYear), 'education' (schoolName; degree, fieldOfStudy, startYear, endYear) o 'certification' (name; authority, issuedYear). index (0 a 19) separa el primer puesto del segundo. |
| dedupeOff | string (JSON) | Opcional | Columnas identificadoras que NO deduplican: subconjunto de 'email', 'personalEmail', 'linkedin'. Al menos un identificador mapeado tiene que seguir deduplicando. |
| linkPublicProfile | string | Opcional | 'true' para vincular en segundo plano el perfil público de cada fila con LinkedIn. Cada vínculo consume un enriquecimiento del workspace. |
columnIndex es la posición de la columna (desde 0), no su nombre: dos columnas pueden llamarse igual.
curl https://app.reclee.com/api/v1/talent/pool/sheet \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-F "file=@candidatos.xlsx" \
-F 'mappings=[{"columnIndex":0,"field":"fullName"},{"columnIndex":1,"field":"email"},{"columnIndex":2,"field":"linkedin"}]' \
-F 'blocks=[{"kind":"experience","index":0,"field":"title","columnIndex":3},{"kind":"experience","index":0,"field":"organizationName","columnIndex":4}]'Respuesta
{
"outcomes": [
{ "line": 2, "name": "Diego Salvatierra", "kind": "created", "profileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d" },
{ "line": 3, "name": "Lucía Ferrer", "kind": "exists", "profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14" },
{ "line": 4, "name": null, "kind": "noName", "profileId": null }
],
"created": 1,
"skippedByCap": 0
}kind: created, exists (ya estaba en el pool), noName, noIdentifier o failed. skippedByCap cuenta las filas que superaron el máximo y no se leyeron.
Vincular LinkedIn consume créditos
La importación en sí es gratis. Con linkPublicProfile=true, el vínculo de cada fila con LinkedIn se hace después, en segundo plano, y cada uno consume un enriquecimiento. Sigue el resultado en la ficha de cada persona (publicLink en GET /talent/pool/{profileId}).
Errores
INVALID(400): el mapeo no cumple las reglas (detalle endetails).INVALID_JSON(400):mappings,blocksodedupeOffno son JSON válido.TOO_LARGE(413): el archivo pesa más de 4 MB.NOT_A_SHEET,OLD_XLS,EMPTY,UNREADABLE(400): el archivo no se pudo leer como planilla.
Etiquetas, no contactar y salidas
POST /talent/pool/tags
/talent/pool/tagsPone una etiqueta, por nombre, a toda una selección. Si el workspace no usa ese nombre todavía, se crea. La respuesta separa a quienes la recibieron ahora, a quienes ya la tenían y a los ids que tu workspace no puede leer.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 500 ids. |
| name | string | Sí | Nombre de la etiqueta, de 1 a 60 caracteres. Sin distinguir mayúsculas. |
curl https://app.reclee.com/api/v1/talent/pool/tags \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"], "name": "remoto" }'Respuesta
{
"tag": { "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "name": "remoto", "color": null },
"tagged": 1,
"taggedIds": ["9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"],
"already": 1,
"unknown": 0
}Para escribir con la acción equivalente: add_profile_tag.
DELETE /talent/pool/tags
/talent/pool/tagsQuita una etiqueta, por nombre, de toda una selección. Mismo body que POST. La etiqueta sigue existiendo en el workspace. Un nombre que el workspace no usa responde 404 NOT_FOUND, igual que la acción remove_profile_tag.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 500 ids. |
| name | string | Sí | Nombre de la etiqueta, de 1 a 60 caracteres. |
curl -X DELETE https://app.reclee.com/api/v1/talent/pool/tags \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14"], "name": "remoto" }'Respuesta
{
"tag": { "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "name": "remoto", "color": null },
"removed": 1,
"removedIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14"]
}Para escribir con la acción equivalente: remove_profile_tag.
PUT /talent/pool/do-not-contact
/talent/pool/do-not-contactMarca «no contactar» a toda una selección, para tu workspace. El motivo es obligatorio. Quien ya estaba marcado conserva su fecha y motivo y no se cuenta en la respuesta. Sólo marca: no hay DELETE.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 500 ids. |
| note | string | Sí | Por qué, de 1 a 500 caracteres. |
curl -X PUT https://app.reclee.com/api/v1/talent/pool/do-not-contact \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"], "note": "Empleados de un cliente activo." }'Respuesta
{ "marked": 2, "markedIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"] }Para escribir con la acción equivalente: set_profile_do_not_contact.
POST /talent/pool/removal
/talent/pool/removalVista previa de qué se llevaría sacar una selección del pool desde la app: no escribe nada. Divide la selección en quienes pueden salir (ready), quienes no porque pasaron por una vacante (blocked, con nombre y vacantes) y quienes no están en tu pool (notHeld). Es un POST sólo porque los ids viajan en el body.
Para sacar personas del pool con una API key, usa remove_from_pool, que archiva sin borrar nada.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 200 ids. |
curl https://app.reclee.com/api/v1/talent/pool/removal \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"] }'Respuesta
{
"ready": ["9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"],
"blocked": [
{ "profileId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c14", "name": "Lucía Ferrer", "jobPosts": ["Frontend Lead"] }
],
"notHeld": [],
"erased": ["9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d"],
"scope": { "cvs": 1, "ownVersions": 1, "notes": 0, "tags": 1, "bookmarks": 0, "paidEnrich": 0 }
}erased son, de ready, quienes sólo tu workspace tuvo alguna vez. scope cuenta lo que tu workspace escribió sobre quienes saldrían.
Duplicados y fusiones
Cuando un mismo email cae en dos o más personas de tu pool, Reclee abre un caso de «posible duplicado». Puedes fusionarlas o cerrar el caso diciendo que son personas distintas.
GET /talent/pool/identity-reviews
/talent/pool/identity-reviewsLos casos abiertos, cada uno con el email que coincide y las personas involucradas (la que quedaría en una fusión, primero).
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | De 1 a 200. Default 20. |
Pagina: devuelve { rows, total, page, pageSize }; aquí el pageSize por default es 20. Ver paginación.
curl "https://app.reclee.com/api/v1/talent/pool/identity-reviews?page=1" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "7b8c9d0e-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"email": "diego.salvatierra@example.com",
"createdAt": "2026-10-01T08:30:00Z",
"people": [
{ "profileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d", "name": "Diego Salvatierra", "headline": "Data Engineer", "currentTitle": "Data Engineer", "currentCompany": "Tramalia", "enriched": true, "hasPublicProfile": true, "avatarUrl": null, "phone": null, "createdAt": "2026-07-01T10:00:00Z" },
{ "profileId": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b", "name": "Diego Salvatierra", "headline": null, "currentTitle": null, "currentCompany": null, "enriched": false, "hasPublicProfile": false, "avatarUrl": null, "phone": "+598 99 123 456", "createdAt": "2026-09-30T15:20:00Z" }
]
}
],
"total": 1,
"page": 1,
"pageSize": 20
}GET /talent/pool/identity-reviews/count
/talent/pool/identity-reviews/countCuántos casos hay abiertos. Responde un número.
curl https://app.reclee.com/api/v1/talent/pool/identity-reviews/count \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
3GET /talent/pool/identity-reviews/{reviewId}
/talent/pool/identity-reviews/{reviewId}Un caso abierto con sus personas. Misma forma que una fila de la lista.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| reviewId | uuid | Sí | El caso. |
curl https://app.reclee.com/api/v1/talent/pool/identity-reviews/7b8c9d0e-1f2a-4b3c-8d4e-5f6a7b8c9d0e \
-H "Authorization: Bearer $RECLEE_API_KEY"Errores
NOT_FOUND(404): el caso no existe o ya se resolvió.
DELETE /talent/pool/identity-reviews/{reviewId}
/talent/pool/identity-reviews/{reviewId}«No son la misma persona»: cierra el caso sin fusionar, para siempre. Si las mismas personas vuelven a coincidir, no se abre un caso nuevo. No borra a nadie. Responde { "id": "…" }.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| reviewId | uuid | Sí | El caso. |
curl -X DELETE https://app.reclee.com/api/v1/talent/pool/identity-reviews/7b8c9d0e-1f2a-4b3c-8d4e-5f6a7b8c9d0e \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{ "id": "7b8c9d0e-1f2a-4b3c-8d4e-5f6a7b8c9d0e" }Errores
NOT_FOUND(404): el caso no existe o ya se resolvió.
Para escribir con la acción equivalente: resolve_merge_candidate con decision: "NOT_SAME_PERSON".
POST /talent/pool/merge/preview
/talent/pool/merge/previewQué movería fusionar a dos personas y quién quedaría. No escribe nada. Quién queda lo decide la regla, no el orden en que mandes los ids: la que tiene perfil público y, entre iguales, la más antigua. people.keep y people.merge lo dicen.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| keepProfileId | uuid | Sí | Una de las dos personas. |
| mergeProfileId | uuid | Sí | La otra. Tiene que ser distinta de keepProfileId. |
curl https://app.reclee.com/api/v1/talent/pool/merge/preview \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keepProfileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d", "mergeProfileId": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b" }'Respuesta (extracto)
{
"applications": 1,
"withdrawnApplications": [],
"notes": 2,
"tags": 1,
"bookmarks": 0,
"contacts": 1,
"cvs": 1,
"identityReviews": 1,
"doNotContact": false,
"suggestedKeepProfileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d",
"people": {
"keep": { "profileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d", "name": "Diego Salvatierra", "hasPublicProfile": true },
"merge": { "profileId": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b", "name": "Diego Salvatierra", "hasPublicProfile": false }
}
}withdrawnApplications lista las postulaciones que chocan (las dos personas en la misma vacante): la perdedora queda retirada detrás de la que gana.
Errores
NOT_FOUND(404): alguna de las dos no está en tu pool.BOTH_HIRED(409): las dos fueron contratadas en la misma vacante.TWO_PUBLIC_PROFILES(409): cada una tiene su propio LinkedIn: son dos personas.
POST /talent/pool/merge
/talent/pool/mergeFusiona dos perfiles de la misma persona, sólo en tu workspace. Es una fusión suave: no se borra nada, la persona fusionada queda apuntando a la que queda, y sus postulaciones, notas, etiquetas, listas, contactos, CVs y adjuntos pasan a esta. Cierra los casos de duplicado que queden con menos de dos personas.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| keepProfileId | uuid | Sí | Una de las dos personas. |
| mergeProfileId | uuid | Sí | La otra. |
curl https://app.reclee.com/api/v1/talent/pool/merge \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keepProfileId": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d", "mergeProfileId": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b" }'Respuesta
{
"keep": "9a1d4e7b-2c3f-4a8e-b6d5-1e0f2a3b4c5d",
"merged": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"applications": 1,
"withdrawnApplications": 0,
"notes": 2,
"tags": 1,
"bookmarks": 0,
"contacts": 1,
"cvs": 1,
"attachments": 0,
"identityReviews": 1
}Errores
NOT_FOUND(404): alguna de las dos no está en tu pool.BOTH_HIRED(409) yTWO_PUBLIC_PROFILES(409): ver la vista previa.
Para escribir con la acción equivalente: resolve_merge_candidate con decision: "MERGE".
CVs y adjuntos
Los CVs no viajan por la API: abres una carga con la lista de archivos (POST /talent/pool/cvs/jobs), recibes una URL firmada por archivo, subes cada archivo con un PUT a su URL y Reclee los lee en segundo plano. El progreso se consulta con GET /talent/pool/cvs/jobs/{jobId}. Un archivo es una lista de uno.
POST /talent/pool/cvs/jobs
/talent/pool/cvs/jobsAbre una carga de hasta 100 CVs y devuelve una URL firmada por archivo, válida durante dos horas. Por la API solo pasa la lista (nombre, tamaño, tipo y hash); los archivos se suben aparte. Un archivo que el workspace ya tenía (mismo sha256) vuelve con uploadUrl: null: no se sube, no se vuelve a leer ni se cobra otra vez, así que reenviar entera una carga cortada solo sube lo que falta. Requiere asiento (rol OWNER o RECRUITER).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| files | object[] | Sí | Entre 1 y 100 archivos. |
| files[].name | string | Sí | Nombre del archivo, de 1 a 500 caracteres. |
| files[].size | integer | Sí | Tamaño en bytes, de 1 a 4194304 (4 MB). |
| files[].type | enum | Sí | 'application/pdf' o 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' (DOCX). |
| files[].sha256 | string | Sí | SHA-256 del archivo en hexadecimal, 64 caracteres en minúscula. |
| profileId | uuid | Opcional | La persona del pool a la que pertenecen los CVs, si ya la conoces. Sin este campo, cada CV crea o encuentra a su persona. |
| linkPublicProfile | boolean | Opcional | Si es true, vincula el perfil público de LinkedIn de quien nombra cada CV. Apagado si no lo envías. Cada vínculo consume uso del plan. |
Acepta Idempotency-Key: un reintento con la misma clave devuelve la primera respuesta en lugar de abrir otra carga. Ver idempotencia.
curl https://app.reclee.com/api/v1/talent/pool/cvs/jobs \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1c2a0e-4b7d-4e59-9a35-1d2f8c7b3e10" \
-d '{
"files": [
{
"name": "laura-mendez-cv.pdf",
"size": 184320,
"type": "application/pdf",
"sha256": "9f2b5c0d8e7a6b1c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c"
}
]
}'Respuesta
{
"jobId": "3b8f6d2a-91c4-4e7b-8a1d-5f0e2c9b7a64",
"items": [
{
"id": "c2e4a7f1-6d3b-4a90-b5e8-1f7c9d2a4b36",
"position": 0,
"fileName": "laura-mendez-cv.pdf",
"uploadUrl": "https://…/laura-mendez-cv.pdf?token=eyJhbGciOi…",
"profileId": null
}
]
}Después, sube cada archivo a su uploadUrl con un PUT, con su tipo como Content-Type:
curl -X PUT "$UPLOAD_URL" \
-H "Content-Type: application/pdf" \
--data-binary @laura-mendez-cv.pdfConsume uso del plan
Cada CV que Reclee lee consume uso de IA del plan, a medida que se lee. La disponibilidad se verifica al abrir la carga: si el plan no tiene margen, la carga se rechaza con USAGE_WINDOW o USAGE_EXHAUSTED (402). Si el margen se agota a mitad de camino, los archivos quedan en espera y se leen cuando vuelve a haberlo (lo indica waitingFor en el progreso).
Errores
SEAT_REQUIRED(403): la key pertenece a alguien sin asiento.BAD_FILE(400): la lista no es válida (tipo, tamaño o hash fuera de rango).TOO_MANY(429): con esta carga tendrías más de 200 archivos propios esperando o leyéndose. Espera a que avancen las cargas abiertas.NOT_FOUND(404): elprofileIdno existe en el workspace.USAGE_WINDOW,USAGE_EXHAUSTED(402): el plan no tiene uso disponible.PAYLOAD_TOO_LARGE(413): el body supera 4,5 MB.
Equivalente como acción: upload_cv.
GET /talent/pool/cvs/jobs/{jobId}
/talent/pool/cvs/jobs/{jobId}El estado de una carga, contado archivo por archivo. Consúltalo periódicamente hasta que finished sea true.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobId | uuid | Sí | El jobId que devolvió POST /talent/pool/cvs/jobs. |
curl https://app.reclee.com/api/v1/talent/pool/cvs/jobs/3b8f6d2a-91c4-4e7b-8a1d-5f0e2c9b7a64 \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"jobId": "3b8f6d2a-91c4-4e7b-8a1d-5f0e2c9b7a64",
"finished": true,
"total": 2,
"done": 2,
"failed": 0,
"created": 1,
"exists": 1,
"noIdentifier": 0,
"alreadyHere": 0,
"waitingFor": null,
"items": [
{
"id": "c2e4a7f1-6d3b-4a90-b5e8-1f7c9d2a4b36",
"position": 0,
"fileName": "laura-mendez-cv.pdf",
"status": "DONE",
"outcome": "CREATED",
"profileId": "8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48",
"error": null,
"duplicateOf": null
},
{
"id": "e9b3c5d7-1a2f-4e86-9c40-3b7d5f1e8a92",
"position": 1,
"fileName": "martin-sosa.docx",
"status": "DONE",
"outcome": "EXISTS",
"profileId": "5f2c8e1a-7d4b-4a3e-b6f9-0c1d2e3f4a5b",
"error": null,
"duplicateOf": null
}
]
}statusde cada archivo:PENDING,RUNNING,DONEoFAILED.outcome(solo cuando estáDONE):CREATED(persona nueva),EXISTS(persona que el pool ya tenía; el CV queda como versión nueva),NO_IDENTIFIER(el CV no permitió identificar a nadie) oALREADY_HERE(el mismo archivo ya estaba).duplicateOf:{ profileId, name }de alguien del pool con el mismo nombre o email, para revisar.waitingFor: el motivo por el que hay archivos esperando sin leerse (USAGE_WINDOW,USAGE_EXHAUSTED, …), onullmientras se lee.
Errores
NOT_FOUND(404): la carga no existe en este workspace.
GET /talent/pool/cvs/jobs/running
/talent/pool/cvs/jobs/runningLa carga más reciente de la persona dueña de la key que todavía no terminó, con la misma forma que GET /talent/pool/cvs/jobs/{jobId}, o null si no hay ninguna. Sirve para retomar el seguimiento si perdiste el jobId. No incluye cargas hechas para una persona concreta (con profileId).
curl https://app.reclee.com/api/v1/talent/pool/cvs/jobs/running \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
nullPOST /talent/pool/cvs/jobs/{jobId}/tick
/talent/pool/cvs/jobs/{jobId}/tickRetirada. Las cargas avanzan solas; esta ruta contesta siempre 410 GONE con la ruta que reemplaza: consulta el progreso con GET /talent/pool/cvs/jobs/{jobId}.
{ "error": "GONE", "use": "/api/v1/talent/pool/cvs/jobs/{jobId}" }POST /talent/pool/cvs
/talent/pool/cvsRetirada. Contesta siempre 410 GONE. Usa POST /talent/pool/cvs/jobs (una carga de un archivo) o la acción upload_cv.
{
"error": "GONE",
"use": "/api/v1/talent/pool/cvs/jobs",
"tool": "/api/v1/actions/upload_cv"
}POST /talent/pool/cvs/batch
/talent/pool/cvs/batchRetirada, con la misma respuesta 410 GONE que POST /talent/pool/cvs. Usa POST /talent/pool/cvs/jobs, que acepta hasta 100 archivos.
GET /talent/pool/cvs/{cvId}/url
/talent/pool/cvs/{cvId}/urlDevuelve un link firmado a un CV, válido durante un minuto. La respuesta es el string de la URL. Pídelo justo antes de abrir el archivo: quien tenga el link puede usarlo hasta que vence.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| cvId | uuid | Sí | El id del CV. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| download | boolean | Opcional | 'true' (default): el link descarga el archivo. 'false': el link lo muestra en el navegador. |
curl "https://app.reclee.com/api/v1/talent/pool/cvs/c2e4a7f1-6d3b-4a90-b5e8-1f7c9d2a4b36/url?download=false" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
"https://…/laura-mendez-cv.pdf?token=eyJhbGciOi…"Errores
NOT_FOUND(404): el CV no existe o es de otro workspace.
GET /talent/pool/attachments/{attachmentId}/url
/talent/pool/attachments/{attachmentId}/urlDevuelve un link firmado a un archivo adjunto a una persona, válido durante un minuto. La respuesta es el string de la URL.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| attachmentId | uuid | Sí | El id del adjunto. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| download | boolean | Opcional | 'true' (default): el link descarga el archivo con su nombre. 'false': el link lo muestra en el navegador (una imagen, un PDF). |
curl "https://app.reclee.com/api/v1/talent/pool/attachments/7d2e9a4c-3f1b-4b68-8e5a-2c9f1d7b3e04/url" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
"https://…/portfolio.pdf?token=eyJhbGciOi…"Errores
NOT_FOUND(404): el adjunto no existe, es de otro workspace o todavía se está subiendo.
Para subir un adjunto: upload_attachment.
Contactos
Los contactos de una persona (email laboral, email personal, teléfono) llegan de dos formas: cargados a mano, que son privados del workspace, o revelados desde el proveedor de datos, que consume créditos. El flujo de un reveal es:
- Estima con
POST /talent/contacts/reveal/estimate: no gasta nada y dice cuánto se compraría de verdad (lo que ya está en el pool, lo ya buscado o en curso no se vuelve a cobrar). - Revela a una persona con
POST /talent/contacts/reveal, o a varias (o a una longlist entera) conPOST /talent/contacts/reveal/batch. - Consulta el estado con
POST /talent/contacts/stateso, para un lote, conGET /talent/contacts/batches/{batchId}.
Cada dato tiene un estado propio, no solo un valor. Los emails suelen resolverse dentro del request; el teléfono tarda más y vuelve como DISPATCHED (pedido y en curso), y se completa segundos después. Estados posibles: null (nunca se buscó), PENDING, DISPATCHED, FOUND, NOT_FOUND y FAILED. Tipos: EMAIL_WORK, EMAIL_PERSONAL y PHONE. Para revelar hace falta asiento (rol OWNER o RECRUITER); solo se puede revelar a alguien con URL de LinkedIn. Nunca se revela a quien está marcado «No contactar» en el workspace: no se busca, no se cotiza y no se cobra.
POST /talent/contacts/reveal/estimate
/talent/contacts/reveal/estimateCalcula lo que costaría un reveal sin gastar nada. Recibe el mismo body que POST /talent/contacts/reveal/batch.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Opcional | Entre 1 y 50 personas del pool. Envía profileIds o longlistId, no los dos. |
| longlistId | uuid | Opcional | Una longlist entera. Envía profileIds o longlistId, no los dos. |
| types | enum[] | Sí | Al menos uno de 'EMAIL_WORK', 'EMAIL_PERSONAL', 'PHONE'. Los repetidos se cuentan una vez. |
| override | boolean | Opcional | Se acepta por compatibilidad con el lote; no cambia la estimación. |
curl https://app.reclee.com/api/v1/talent/contacts/reveal/estimate \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"longlistId": "1e7b3c9d-5a2f-4d84-b6e1-9c0a7f3d2b58",
"types": ["EMAIL_WORK", "PHONE"]
}'Respuesta
{
"profiles": 40,
"requested": 80,
"toBuy": 52,
"alreadyHave": 18,
"alreadySearched": 6,
"inFlight": 0,
"withoutLinkedin": 4,
"doNotContact": 1,
"workspaceCredits": 61,
"fitsInBalance": true,
"balanceUnchecked": false,
"fitsCredit": true,
"exceedsCap": false
}requestedes personas × tipos;toBuyes lo que de verdad se compraría. La diferencia es lo que no se cobra:alreadyHave(ya está),alreadySearched(ya se buscó hace poco sin resultado),inFlight(en curso) ywithoutLinkedin(no se puede buscar).doNotContact: cuántas personas quedan afuera por estar marcadas «No contactar». No entran entoBuyni en el costo.workspaceCredits: los créditos del workspace que se cobrarían si se encuentra todo, según el plan. Solo se cobra lo que se encuentra.fitsCredit: el crédito del workspace alcanza. Si esfalse, el reveal fallará conNO_CREDITS.fitsInBalance/balanceUnchecked: si el proveedor de datos puede atenderlo ahora. Confalse/truerespectivamente, el lote se rechaza conPROVIDER_NO_CREDITS.exceedsCap: el lote supera el tope por lote; verTOO_LARGEen el lote.
Errores
NOT_FOUND(404): alguna persona o la longlist no existe en el workspace.SEAT_REQUIRED(403): la key pertenece a alguien sin asiento.
POST /talent/contacts/reveal
/talent/contacts/revealRevela los contactos de una persona. Espera unos segundos a que lleguen los emails y devuelve un estado por tipo pedido. El teléfono suele volver como DISPATCHED: consulta POST /talent/contacts/states hasta que pase a FOUND, NOT_FOUND o FAILED. Si todo lo pedido ya se conocía o está en curso, devuelve el estado actual sin gastar.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona del pool. |
| types | enum[] | Sí | Al menos uno de 'EMAIL_WORK', 'EMAIL_PERSONAL', 'PHONE'. |
Acepta Idempotency-Key (idempotencia).
Consume créditos
Cada dato que se encuentra se cobra en créditos del workspace; lo que no se encuentra no se cobra. Estima antes con POST /talent/contacts/reveal/estimate.
curl https://app.reclee.com/api/v1/talent/contacts/reveal \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 0a9d8c7b-6e5f-4a3b-9c2d-1e0f9a8b7c6d" \
-d '{
"profileId": "8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48",
"types": ["EMAIL_WORK", "PHONE"]
}'Respuesta
[
{
"type": "EMAIL_WORK",
"status": "FOUND",
"value": "laura.mendez@nortelogistica.com",
"resolvedAt": "2026-10-22T14:03:11.000Z"
},
{
"type": "PHONE",
"status": "DISPATCHED",
"value": null,
"resolvedAt": null
}
]Errores
NOT_FOUND(404): la persona no existe en el workspace.DO_NOT_CONTACT(409): la persona está marcada «No contactar» en el workspace. No se gasta nada.NO_CREDITS(402): el crédito del workspace no alcanza.PROVIDER_NO_CREDITS(503): el proveedor de datos no puede atender el pedido ahora.SEAT_REQUIRED(403): la key pertenece a alguien sin asiento.
Equivalente como acción: enrich_contact.
POST /talent/contacts/reveal/batch
/talent/contacts/reveal/batchRevela los contactos de hasta 50 personas, o de una longlist entera, en segundo plano. Responde apenas el trabajo queda registrado, sin esperar los datos: sigue el progreso con GET /talent/contacts/batches/{batchId}.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Opcional | Entre 1 y 50 personas del pool. Envía profileIds o longlistId, no los dos. |
| longlistId | uuid | Opcional | Una longlist entera. Envía profileIds o longlistId, no los dos. |
| types | enum[] | Sí | Al menos uno de 'EMAIL_WORK', 'EMAIL_PERSONAL', 'PHONE'. |
| override | boolean | Opcional | Supera el tope por lote. Solo lo puede usar un OWNER; nunca es el default. |
Acepta Idempotency-Key (idempotencia).
Consume créditos
El crédito necesario se reserva al crear el lote, se cobra lo que se encuentra y se libera lo que no. Estima antes con POST /talent/contacts/reveal/estimate (mismo body): mira toBuy, workspaceCredits, fitsCredit y exceedsCap.
curl https://app.reclee.com/api/v1/talent/contacts/reveal/batch \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 4c3b2a19-0f8e-4d7c-b6a5-948372615f0e" \
-d '{
"longlistId": "1e7b3c9d-5a2f-4d84-b6e1-9c0a7f3d2b58",
"types": ["EMAIL_WORK", "PHONE"]
}'Respuesta
{
"batchId": "a6f0c3e8-2d7b-4b19-8e54-0c1f9d3a7b25",
"total": 52,
"credits": 65,
"skipped": [
{ "profileId": "8c2e4a6b-0d1f-4e3a-9b5c-7d9e1f3a5b7c", "reason": "DO_NOT_CONTACT" }
]
}total es la cantidad de búsquedas registradas y credits el costo estimado del lote. Para los créditos de tu workspace, usa workspaceCredits de la estimación. skipped lista a las personas pedidas que el lote dejó afuera, con su motivo: hoy el único es DO_NOT_CONTACT (marcadas «No contactar»).
Errores
NOTHING_TO_REVEAL(409): todo lo pedido ya se conoce, se buscó hace poco, está en curso o no se puede buscar.DO_NOT_CONTACT(409): todas las personas pedidas están marcadas «No contactar».TOO_LARGE(413): el lote supera el tope por lote. UnOWNERpuede repetirlo conoverride: true.NO_CREDITS(402): el crédito del workspace no alcanza.PROVIDER_NO_CREDITS(503): el proveedor de datos no puede atender el lote ahora. Se verifica antes de gastar nada.NOT_FOUND(404): alguna persona o la longlist no existe en el workspace.SEAT_REQUIRED(403): la key pertenece a alguien sin asiento.
Equivalente como acción: enrich_contact.
GET /talent/contacts/batches/{batchId}
/talent/contacts/batches/{batchId}El progreso de un reveal por lote. No hay estimación de cuándo termina: consúltalo periódicamente hasta que pending sea 0. total cuenta las búsquedas que el lote registró de verdad (puede ser menor que lo que se planeó, si alguien entró en curso o fue marcado «No contactar» mientras tanto), así que pending siempre llega a 0. Los valores encontrados se leen con POST /talent/contacts/states.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| batchId | uuid | Sí | El batchId que devolvió POST /talent/contacts/reveal/batch. |
curl https://app.reclee.com/api/v1/talent/contacts/batches/a6f0c3e8-2d7b-4b19-8e54-0c1f9d3a7b25 \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"id": "a6f0c3e8-2d7b-4b19-8e54-0c1f9d3a7b25",
"total": 52,
"pending": 9,
"found": 35,
"notFound": 7,
"failed": 1,
"types": ["EMAIL_WORK", "PHONE"],
"estimatedCredits": 65,
"createdAt": "2026-10-22T14:10:02.000Z"
}Errores
NOT_FOUND(404): el lote no existe en el workspace.
POST /talent/contacts/states
/talent/contacts/statesLo que se sabe hoy de los contactos de varias personas, incluido lo que está en curso. No compra nada. Es POST porque recibe una lista de ids. Devuelve un objeto por profileId con los tres tipos; alguien a quien nunca se buscó vuelve con los tres status en null.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 500 personas. |
curl https://app.reclee.com/api/v1/talent/contacts/states \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48"] }'Respuesta
{
"8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48": [
{
"type": "EMAIL_WORK",
"status": "FOUND",
"value": "laura.mendez@nortelogistica.com",
"resolvedAt": "2026-10-22T14:03:11.000Z"
},
{
"type": "EMAIL_PERSONAL",
"status": null,
"value": null,
"resolvedAt": null
},
{
"type": "PHONE",
"status": "FOUND",
"value": "+54 11 5555 0142",
"resolvedAt": "2026-10-22T14:03:40.000Z"
}
]
}resolvedAt distingue «nunca se buscó» de «se buscó y no hay nada»: es la fecha en que la búsqueda terminó, o null mientras no terminó.
POST /talent/pool/{profileId}/contacts
/talent/pool/{profileId}/contactsAgrega un contacto cargado a mano a una persona. Es privado del workspace y no consume créditos. Si el contacto ya existía, devuelve el existente.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona del pool. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| type | enum | Opcional | 'EMAIL_WORK', 'EMAIL_PERSONAL' o 'PHONE'. Sin type, value tiene que ser un email y el tipo (laboral o personal) se deduce del dominio. |
| value | string | Sí | El email o teléfono, hasta 254 caracteres. Un teléfono acepta dígitos, espacios, +, paréntesis, puntos y guiones, con al menos 6 dígitos. Los emails se guardan en minúscula. |
Acepta Idempotency-Key (idempotencia).
curl https://app.reclee.com/api/v1/talent/pool/8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48/contacts \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "type": "PHONE", "value": "+54 11 5555 0142" }'Respuesta
{
"id": "f3a9c1e7-5b2d-4e80-a6c4-2d8f0b7e1c93",
"type": "PHONE",
"value": "+54 11 5555 0142",
"source": "MANUAL",
"createdAt": "2026-10-22T14:20:45.000Z",
"removable": true
}Errores
INVALID(400): el valor no es válido para su tipo.NOT_FOUND(404): la persona no existe en el workspace.FORBIDDEN(403): el rol de la key no puede escribir.
Equivalente como acción: add_profile_contact.
PATCH /talent/pool/{profileId}/contacts/{contactId}
/talent/pool/{profileId}/contacts/{contactId}Corrige en el lugar un contacto cargado a mano en este workspace. Devuelve el contacto corregido.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | uuid | Sí | La persona del pool. |
| contactId | uuid | Sí | El contacto a corregir. |
Body
Igual que en POST /talent/pool/{profileId}/contacts:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| type | enum | Opcional | 'EMAIL_WORK', 'EMAIL_PERSONAL' o 'PHONE'. Sin type, value tiene que ser un email. |
| value | string | Sí | El valor nuevo, hasta 254 caracteres. |
curl -X PATCH https://app.reclee.com/api/v1/talent/pool/8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48/contacts/f3a9c1e7-5b2d-4e80-a6c4-2d8f0b7e1c93 \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "type": "PHONE", "value": "+54 11 5555 0199" }'Respuesta
{
"id": "f3a9c1e7-5b2d-4e80-a6c4-2d8f0b7e1c93",
"type": "PHONE",
"value": "+54 11 5555 0199",
"source": "MANUAL",
"createdAt": "2026-10-22T14:20:45.000Z",
"removable": true
}Errores
CONTACT_ALREADY_KNOWN(409): la persona ya tiene ese valor.NOT_FOUND(404): el contacto no existe, no es de esta persona o no fue cargado a mano en este workspace.INVALID(400): el valor no es válido para su tipo.
Equivalente como acción: update_profile_contact.
DELETE /talent/pool/{profileId}/contacts/{contactId}
/talent/pool/{profileId}/contacts/{contactId}Una key no borra contactos: contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_profile_contact" }]. Para corregir un contacto, usa PATCH sobre esta ruta o POST /actions/update_profile_contact (update_profile_contact).
Perfiles y enriquecimiento
El registro de LinkedIn de una persona (experiencia, educación, skills, idiomas) se obtiene enriqueciéndola desde el proveedor de datos, lo que consume créditos. Primero planifica con POST /talent/profiles/enrich/plan, después enriquece con POST /talent/profiles/enrich y lee el resultado con GET /talent/profiles.
GET /talent/profiles
/talent/profilesEl registro de LinkedIn guardado de las personas pedidas: titular, resumen, experiencia (la más reciente primero), educación, skills e idiomas. La experiencia, la educación, las skills y los idiomas solo vienen para quien este workspace ya enriqueció; para el resto vuelven como listas vacías.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | string[] (separado por comas) | Sí | Los ids de las personas. |
curl "https://app.reclee.com/api/v1/talent/profiles?profileIds=8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
[
{
"profileId": "8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48",
"headline": "Head of Logistics · Supply chain",
"summary": "Doce años liderando operaciones de distribución en la región.",
"experience": [
{
"title": "Head of Logistics",
"organizationName": "Norte Logística",
"logoUrl": null,
"employmentType": "Full-time",
"location": "Buenos Aires, Argentina",
"description": null,
"isCurrent": true,
"startYear": 2021,
"startMonth": 3,
"endYear": null,
"endMonth": null
}
],
"education": [
{
"schoolName": "Universidad del Litoral",
"logoUrl": null,
"degree": "Ingeniería Industrial",
"fieldOfStudy": null,
"startYear": 2008,
"endYear": 2013
}
],
"skills": ["Supply Chain Management", "SAP"],
"languages": [{ "name": "English", "proficiency": "PROFESSIONAL_WORKING" }]
}
]Errores
INVALID(400): faltaprofileIds.
POST /talent/profiles/enrich/plan
/talent/profiles/enrich/planLo que haría POST /talent/profiles/enrich con el mismo body, sin gastar nada.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 50 personas del pool. Los repetidos cuentan una vez. |
curl https://app.reclee.com/api/v1/talent/profiles/enrich/plan \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48", "5f2c8e1a-7d4b-4a3e-b6f9-0c1d2e3f4a5b"] }'Respuesta
{
"total": 2,
"stale": 1,
"fresh": 1,
"withoutProviderKey": 0
}stale: personas que se cobrarían (desactualizadas, o nunca enriquecidas por este workspace).fresh: ya enriquecidas por este workspace y al día (menos de 30 días): no se hace nada.withoutProviderKey: personas sin identificador en el proveedor de datos; se saltean.
Errores
NOT_FOUND(404): alguna persona no está en el pool del workspace.SEAT_REQUIRED(403): la key pertenece a alguien sin asiento.
POST /talent/profiles/enrich
/talent/profiles/enrichEnriquece hasta 50 personas del pool con su registro completo de LinkedIn. Solo se paga por quien lo necesita (los stale del plan). Es sincrónico: responde cuando todo quedó escrito.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Entre 1 y 50 personas del pool. Los repetidos cuentan una vez. |
Acepta Idempotency-Key (idempotencia).
Consume créditos
Cada persona desactualizada o nunca enriquecida por este workspace se cobra en créditos. Estima antes con POST /talent/profiles/enrich/plan: stale es la cantidad que se cobraría.
curl https://app.reclee.com/api/v1/talent/profiles/enrich \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 2d4f6a8c-1e3b-4c5d-9f7a-8b6c4d2e0f13" \
-d '{ "profileIds": ["8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48", "5f2c8e1a-7d4b-4a3e-b6f9-0c1d2e3f4a5b"] }'Respuesta
{
"total": 2,
"skipped": 1,
"enriched": 1,
"notFound": [],
"credits": 1,
"withoutProviderKey": 0
}skipped son las personas que no hizo falta pedir; notFound, los identificadores para los que el proveedor de datos no tenía registro.
Errores
NOT_FOUND(404): alguna persona no está en el pool del workspace.NO_CREDITS(402): el crédito del workspace no alcanza.USAGE_WINDOW,USAGE_EXHAUSTED(402): el plan no tiene uso disponible.INSUFFICIENT_CREDITS,PROVIDER_UNAVAILABLE(503): el proveedor de datos no puede atender el pedido ahora.RATE_LIMITED(429): el proveedor de datos pidió esperar; respetaRetry-After.SEAT_REQUIRED(403): la key pertenece a alguien sin asiento.
Equivalente como acción: enrich_profile.
POST /talent/profiles/match
/talent/profiles/matchFiltra una lista de personas por skills, idiomas, email, teléfono o listas, y devuelve los ids que cumplen. [] significa que nadie cumple. Dentro de un campo alcanza con cualquiera de sus valores; entre campos tienen que cumplirse todos los que enviaste. Sin filtros, devuelve los mismos ids. No escribe nada.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | Las personas a filtrar, hasta 5000. Solo se lee este alcance, no el resto del pool. |
| filters | object | Sí | Los filtros. Puede ser un objeto vacío. |
| filters.skills | string[] | Opcional | Hasta 50 nombres de skill. |
| filters.languages | object[] | Opcional | Hasta 20 idiomas: { name, level }. level es opcional: 'ELEMENTARY', 'LIMITED_WORKING', 'PROFESSIONAL_WORKING', 'FULL_PROFESSIONAL' o 'NATIVE_OR_BILINGUAL'. |
| filters.email | string | Opcional | Parte de un email guardado, hasta 320 caracteres. |
| filters.phone | string | Opcional | Parte de un teléfono guardado, hasta 40 caracteres. |
| filters.bookmarkIds | uuid[] | Opcional | Hasta 100 listas: la persona tiene que estar en alguna. |
curl https://app.reclee.com/api/v1/talent/profiles/match \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profileIds": [
"8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48",
"5f2c8e1a-7d4b-4a3e-b6f9-0c1d2e3f4a5b"
],
"filters": {
"skills": ["SAP"],
"languages": [{ "name": "English", "level": "PROFESSIONAL_WORKING" }]
}
}'Respuesta
["8a1d4f7e-2b6c-4c93-9e05-7d3a1b6f2c48"]Listas
Las listas agrupan personas del pool de talento bajo un nombre. Una lista nace privada (sólo la ve quien la creó) y se comparte con todo el workspace cuando su dueño la marca como pública. El nombre, la descripción, la visibilidad y el borrado son del dueño; el contenido lo puede editar cualquier miembro que vea la lista. Sólo entran personas que ya están en el pool del workspace: los ids que no lo están se ignoran.
GET /talent/bookmarks
/talent/bookmarksDevuelve las listas que puedes ver: las compartidas del workspace y tus listas privadas, de la más nueva a la más vieja. La lista privada de otra persona nunca aparece.
Pagina: devuelve { rows, total, page, pageSize } con page (desde 1) y pageSize (hasta 200, default 50). Ver paginación.
curl "https://app.reclee.com/api/v1/talent/bookmarks?page=1&pageSize=50" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01",
"name": "Backend senior LATAM",
"description": "Perfiles para clientes fintech",
"isPrivate": false,
"ownerId": "8d2e4f6a-1b3c-4d5e-8f9a-0b1c2d3e4f50",
"ownerName": "Lucía Méndez",
"isOwn": true,
"profileCount": 42,
"createdAt": "2026-09-14T13:22:05.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}ownerName es null si el dueño no tiene nombre cargado. isOwn dice si la lista es tuya (sólo el dueño puede renombrarla, compartirla o borrarla).
POST /talent/bookmarks
/talent/bookmarksCrea una lista. Su dueño es siempre quien llama: un dueño indicado en el body se ignora. Opcionalmente archiva personas en la misma llamada. Acepta Idempotency-Key (ver idempotencia).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre de la lista, de 1 a 80 caracteres. |
| description | string | null | Opcional | Hasta 280 caracteres. Default: null. |
| isPrivate | boolean | Opcional | Default: true. La lista nace privada salvo que pidas lo contrario. |
| profileIds | uuid[] | Opcional | Hasta 500 personas para archivar en la lista al crearla. Sólo entran las que están en el pool. |
| id | uuid | Opcional | Id a usar para la lista, si quieres elegirlo tú. Si se omite, lo genera Reclee. |
curl -X POST "https://app.reclee.com/api/v1/talent/bookmarks" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6c1d7c0e-2f4b-4a51-9a0e-1f2b3c4d5e6f" \
-d '{
"name": "Backend senior LATAM",
"profileIds": ["b7e2c1d4-5a6f-4b3c-8d2e-1f0a9b8c7d61"]
}'Respuesta
Devuelve la lista creada, con la misma forma que una fila de GET /talent/bookmarks. profileCount cuenta a quienes efectivamente entraron.
{
"id": "3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01",
"name": "Backend senior LATAM",
"description": null,
"isPrivate": true,
"ownerId": "8d2e4f6a-1b3c-4d5e-8f9a-0b1c2d3e4f50",
"ownerName": "Lucía Méndez",
"isOwn": true,
"profileCount": 1,
"createdAt": "2026-10-22T10:04:11.000Z"
}Errores
FORBIDDEN(403): tu rol no puede escribir (por ejemplo, unVIEWER).NOT_FOUND(404): mandasteprofileIdsy ninguno está en el pool. No se crea la lista.
Para escribir con una acción: create_bookmark.
GET /talent/bookmarks/{bookmarkId}
/talent/bookmarks/{bookmarkId}Devuelve quién está en la lista, como ids de perfil. Para leer los datos de cada persona, usa GET /talent/pool con el filtro bookmarkIds o el detalle de cada perfil.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | uuid | Sí | Id de la lista. |
Pagina: devuelve { rows, total, page, pageSize } con page (desde 1) y pageSize (hasta 200, default 50). Ver paginación.
curl "https://app.reclee.com/api/v1/talent/bookmarks/3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01?page=1" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
"b7e2c1d4-5a6f-4b3c-8d2e-1f0a9b8c7d61",
"c2a4e6f8-0b1d-4c3e-9f5a-7b9c1d3e5f72"
],
"total": 2,
"page": 1,
"pageSize": 50
}Una lista que no existe o que no puedes ver devuelve una página vacía.
PATCH /talent/bookmarks/{bookmarkId}
/talent/bookmarks/{bookmarkId}Renombra, describe o comparte una lista. Manda sólo los campos que cambian; al menos uno. Sólo el dueño puede hacerlo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | uuid | Sí | Id de la lista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Opcional | De 1 a 80 caracteres. |
| description | string | null | Opcional | Hasta 280 caracteres; null la borra. |
| isPrivate | boolean | Opcional | false la comparte con el workspace; true la vuelve privada. |
curl -X PATCH "https://app.reclee.com/api/v1/talent/bookmarks/3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "isPrivate": false }'Respuesta
La lista actualizada, con la misma forma que en POST /talent/bookmarks.
Errores
INVALID(400): body vacío o con valores fuera de rango.NOT_FOUND(404): la lista no existe o no es tuya. Las dos situaciones contestan igual a propósito, para no confirmar que existe la lista privada de otra persona.
Para escribir con una acción: update_bookmark o set_bookmark_visibility.
DELETE /talent/bookmarks/{bookmarkId}
/talent/bookmarks/{bookmarkId}Borra la lista. Las personas que estaban en ella siguen en el pool: sólo desaparece la agrupación. Sólo el dueño puede borrarla.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | uuid | Sí | Id de la lista. |
curl -X DELETE "https://app.reclee.com/api/v1/talent/bookmarks/3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
trueErrores
NOT_FOUND(404): la lista no existe o no es tuya.
Para escribir con una acción: delete_bookmark.
POST /talent/bookmarks/{bookmarkId}/profiles
/talent/bookmarks/{bookmarkId}/profilesAgrega personas a la lista. Devuelve cuántas entraron nuevas: quien ya estaba no cuenta, y quien no está en el pool se ignora.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | uuid | Sí | Id de la lista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | De 1 a 500 ids de perfil. |
curl -X POST "https://app.reclee.com/api/v1/talent/bookmarks/3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01/profiles" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["b7e2c1d4-5a6f-4b3c-8d2e-1f0a9b8c7d61", "c2a4e6f8-0b1d-4c3e-9f5a-7b9c1d3e5f72"] }'Respuesta
1Errores
NOT_FOUND(404): la lista no existe o no la ves, o ninguna de las personas está en el pool.
Para escribir con una acción: add_to_bookmark.
DELETE /talent/bookmarks/{bookmarkId}/profiles
/talent/bookmarks/{bookmarkId}/profilesSaca personas de la lista (no del pool). Lleva body JSON, igual que el POST. Devuelve cuántas salieron.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | uuid | Sí | Id de la lista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | De 1 a 500 ids de perfil. |
curl -X DELETE "https://app.reclee.com/api/v1/talent/bookmarks/3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01/profiles" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["c2a4e6f8-0b1d-4c3e-9f5a-7b9c1d3e5f72"] }'Respuesta
1Para escribir con una acción: remove_from_bookmark.
POST /talent/bookmarks/{bookmarkId}/longlists
/talent/bookmarks/{bookmarkId}/longlistsVuelca en la lista a todas las personas de una longlist de sourcing, sin que tengas que conocer sus ids. Devuelve cuántas entraron nuevas: volcar la misma longlist dos veces devuelve 0.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | uuid | Sí | Id de la lista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | Id de la longlist a volcar. |
curl -X POST "https://app.reclee.com/api/v1/talent/bookmarks/3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01/longlists" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "longlistId": "a9b8c7d6-e5f4-4a3b-9c2d-1e0f9a8b7c63" }'Respuesta
37Errores
NOT_FOUND(404): la longlist está vacía o no la ves, o la lista no existe o no la ves.
Para escribir con una acción: add_longlist_to_bookmark.
POST /talent/bookmarks/membership
/talent/bookmarks/membershipPara un conjunto de personas, dice cuántas de ellas ya tiene cada lista. Es una lectura: usa POST porque una selección de hasta 500 ids no entra en una query string. Las listas que no tienen a ninguna no aparecen en la respuesta.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | uuid[] | Sí | De 1 a 500 ids de perfil. |
curl -X POST "https://app.reclee.com/api/v1/talent/bookmarks/membership" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["b7e2c1d4-5a6f-4b3c-8d2e-1f0a9b8c7d61", "c2a4e6f8-0b1d-4c3e-9f5a-7b9c1d3e5f72"] }'Respuesta
Un objeto con el id de cada lista como clave y la cantidad de esas personas que contiene como valor.
{
"3f1c2a9e-7b4d-4e2a-9c1f-5a6b7c8d9e01": 2,
"5d6e7f80-91a2-4b3c-8d4e-5f6a7b8c9d02": 1
}Búsquedas de talento
Una búsqueda de talento busca personas en el índice externo de perfiles sin una vacante detrás: le pasas filtros (cargo, skills, país, idiomas…) y trae una página de hasta 20 personas, enriquecidas. Cada búsqueda queda guardada con sus filtros y puedes pedirle más páginas. Si refinas una búsqueda, la nueva queda encadenada a la anterior y su number sigue la secuencia («Búsqueda 2», «Búsqueda 3»…).
GET /talent/searches
/talent/searchesLista las búsquedas del workspace, de la más nueva a la más vieja.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| threadId | uuid | Opcional | Sólo las búsquedas lanzadas desde esa conversación de Ask Reclee. |
| page | integer | Opcional | Página, desde 1. Default: 1. |
| pageSize | integer | Opcional | Hasta 200. Default: 50. |
Una clave desconocida en la query contesta 400 INVALID.
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/talent/searches?page=1&pageSize=20" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "e4d3c2b1-a09f-4e8d-9c7b-6a5f4e3d2c11",
"threadId": null,
"replacesId": "0f9e8d7c-6b5a-4f3e-8d2c-1b0a9f8e7d22",
"createdAt": "2026-10-21T15:40:12.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 20
}Para leer los filtros y las personas de una búsqueda, usa GET /talent/searches/{searchId}.
POST /talent/searches
/talent/searchesEjecuta una búsqueda nueva y trae su primera página: hasta 20 personas, enriquecidas. Devuelve la búsqueda completa con sus personas. Acepta Idempotency-Key (ver idempotencia); úsalo siempre, porque reintentar sin él paga otra página.
Consume créditos
Cada página reserva antes de empezar una búsqueda en el proveedor de datos y el enriquecimiento de hasta 20 perfiles, contra el uso y los créditos del plan. Si no alcanza, la llamada se rechaza sin gastar nada (402). Para ver a quién traería una búsqueda antes de pagar el enriquecimiento, usa la acción search_talent_preview, que sólo paga la búsqueda y no enriquece ni guarda a nadie. Si todavía no tienes los filtros, POST /talent/searches/propose los arma a partir de un texto.
Requiere un rol con asiento (OWNER o RECRUITER).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| query | object | Sí | Los filtros de la búsqueda (tabla siguiente). Al menos uno es obligatorio. |
| replacesId | uuid | Opcional | La búsqueda que esta refina: la nueva toma el número siguiente de esa cadena. |
Filtros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| title | string | Opcional | Cargo actual. Mínimo 3 caracteres. |
| headline | string | Opcional | Texto del titular del perfil. Mínimo 3 caracteres. |
| skills | string[] | Opcional | Skills, hasta 20. |
| geoCountryCode | string | Opcional | País, código ISO de 2 letras (por ejemplo 'ar'). Se guarda en minúsculas. |
| geoCity | string | Opcional | Ciudad, mínimo 3 caracteres. Exige geoCountryCode. |
| experienceMinYears | integer | Opcional | Años mínimos de experiencia, de 1 a 60. |
| speaksLanguage | string[] | Opcional | Idiomas que habla, hasta 20. |
| industry | string[] | Opcional | Industrias, hasta 20, de al menos 3 caracteres cada una. |
| organizationSlugs | string[] | Opcional | Empresas (identificador corto de la empresa), hasta 20. |
| educationLevel | enum | Opcional | Nivel educativo: 'phd', 'master', 'bachelor' o 'associate'. |
| certifications | string[] | Opcional | Certificaciones, hasta 20. |
| excludeTitles | string[] | Opcional | Cargos a excluir, hasta 20, de al menos 3 caracteres. |
| excludeOrganizationSlugs | string[] | Opcional | Empresas a excluir, hasta 20. |
| excludeIndustries | string[] | Opcional | Industrias a excluir, hasta 20, de al menos 3 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/talent/searches" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 1b2c3d4e-5f60-4a7b-8c9d-0e1f2a3b4c5d" \
-d '{
"query": {
"title": "Backend Engineer",
"skills": ["Go", "PostgreSQL"],
"geoCountryCode": "ar",
"experienceMinYears": 5
}
}'Respuesta (extracto)
{
"id": "e4d3c2b1-a09f-4e8d-9c7b-6a5f4e3d2c11",
"number": 1,
"query": {
"schemaVersion": 1,
"title": "Backend Engineer",
"skills": ["Go", "PostgreSQL"],
"geoCountryCode": "ar",
"experienceMinYears": 5
},
"threadId": null,
"replacesId": null,
"createdAt": "2026-10-22T10:15:00.000Z",
"people": [
{
"profileId": "b7e2c1d4-5a6f-4b3c-8d2e-1f0a9b8c7d61",
"name": "Martín Ferreyra",
"headline": "Senior Backend Engineer · Go · Distributed systems",
"currentTitle": "Senior Backend Engineer",
"currentCompany": "Pagoflex",
"location": "Córdoba, Argentina",
"avatarUrl": null,
"doNotContact": false,
"inPool": false,
"page": 1
}
],
"pages": 1,
"hasMore": true
}people viene en orden de llegada y cada persona aparece una sola vez. inPool dice si la persona está guardada en el pool del workspace. hasMore pasa a false cuando no quedan más páginas.
Errores
INVALID(400): sin filtros, ogeoCitysingeoCountryCode.SEAT_REQUIRED(403): tu rol no tiene asiento.NOT_FOUND(404):replacesIdno es una búsqueda de este workspace.USAGE_WINDOW,USAGE_EXHAUSTED,NO_CREDITSy demás bloqueos de facturación (402): el plan no cubre la página. Ver errores.PAGE_IN_FLIGHT(409): ya hay una página de esta búsqueda en curso.RATE_LIMITED(429),PROVIDER_UNAVAILABLE/INSUFFICIENT_CREDITS(503): el proveedor de datos no pudo atender la búsqueda; reintenta más tarde.
Para escribir con una acción: search_talent.
GET /talent/searches/{searchId}
/talent/searches/{searchId}Devuelve una búsqueda: sus filtros, su número, todas las personas que trajo en orden de llegada, cuántas páginas lleva y si hay más. No gasta nada.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| searchId | uuid | Sí | Id de la búsqueda. |
curl "https://app.reclee.com/api/v1/talent/searches/e4d3c2b1-a09f-4e8d-9c7b-6a5f4e3d2c11" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
La misma forma que en POST /talent/searches.
Errores
NOT_FOUND(404): la búsqueda no existe en este workspace.
POST /talent/searches/{searchId}/next
/talent/searches/{searchId}/nextTrae la página siguiente de la búsqueda (hasta 20 personas más) y devuelve la búsqueda completa actualizada. Si una página falla, pedirla de nuevo reintenta la misma, no la saltea. Acepta Idempotency-Key (ver idempotencia).
Consume créditos
Cada página se paga igual que la primera: una búsqueda en el proveedor más el enriquecimiento de hasta 20 perfiles. Antes de pedirla, mira hasMore en GET /talent/searches/{searchId}: si es false, la llamada contesta NO_MORE_RESULTS sin reservar nada.
Requiere un rol con asiento (OWNER o RECRUITER). Sin body.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| searchId | uuid | Sí | Id de la búsqueda. |
curl -X POST "https://app.reclee.com/api/v1/talent/searches/e4d3c2b1-a09f-4e8d-9c7b-6a5f4e3d2c11/next" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"Respuesta
La búsqueda completa, con la forma de POST /talent/searches; pages sube en uno y las personas nuevas traen page con el número de la página en que llegaron.
Errores
NOT_FOUND(404): la búsqueda no existe en este workspace.NO_MORE_RESULTS(409): no quedan páginas.PAGE_IN_FLIGHT(409): ya hay una página de esta búsqueda en curso.SEAT_REQUIRED(403), bloqueos de facturación (402) y errores del proveedor (429, 503), como enPOST /talent/searches.
Para escribir con una acción: load_more_talent.
POST /talent/searches/propose
/talent/searches/proposeConvierte un pedido en lenguaje natural en los filtros que acepta POST /talent/searches. No guarda nada ni consulta el proveedor de datos: sólo usa el modelo de IA, así que puede tardar varios segundos. Acepta Idempotency-Key (ver idempotencia).
El uso de IA cuenta contra el plan: si no queda, contesta un bloqueo de facturación (402).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| text | string | Sí | El pedido en palabras, de 3 a 2000 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/talent/searches/propose" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "text": "Ingenieros backend en Argentina con 5 años o más, que sepan Go y PostgreSQL" }'Respuesta
Un objeto de filtros listo para mandar como query. Sólo trae los filtros que el texto permitió deducir.
{
"title": "Backend Engineer",
"skills": ["Go", "PostgreSQL"],
"geoCountryCode": "ar",
"experienceMinYears": 5
}Errores
INVALID(400): el texto no permite deducir ningún filtro.FORBIDDEN(403): tu rol no puede escribir.- Bloqueos de facturación (402): el plan no cubre el uso de IA.
Vocabulario de etiquetas
Las etiquetas son el vocabulario del workspace para marcar personas del pool («inglés nativo», «referido»…). Se archivan, no se borran: archivar una etiqueta la saca de las sugerencias sin desetiquetar a nadie, y crearla de nuevo con el mismo nombre la recupera. Para poner o sacar una etiqueta a una persona, ve POST /profiles/{profileId}/tags.
GET /talent/tags
/talent/tagsDevuelve las etiquetas activas del workspace, en orden alfabético, cada una con cuántas personas la llevan.
Pagina: devuelve { rows, total, page, pageSize } con page (desde 1) y pageSize (hasta 200, default 50). Ver paginación.
curl "https://app.reclee.com/api/v1/talent/tags?page=1" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{ "id": "4a5b6c7d-8e9f-4a0b-9c1d-2e3f4a5b6c71", "name": "inglés nativo", "color": "blue", "profileCount": 18 },
{ "id": "5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d82", "name": "referido", "color": null, "profileCount": 3 }
],
"total": 2,
"page": 1,
"pageSize": 50
}POST /talent/tags
/talent/tagsCrea una etiqueta. Si el nombre pertenece a una etiqueta archivada, la recupera en lugar de crear otra. Acepta Idempotency-Key (ver idempotencia).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | De 1 a 60 caracteres. |
| color | string | null | Opcional | Color de la etiqueta, hasta 20 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/talent/tags" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f" \
-d '{ "name": "inglés nativo", "color": "blue" }'Respuesta
{ "id": "4a5b6c7d-8e9f-4a0b-9c1d-2e3f4a5b6c71", "name": "inglés nativo", "color": "blue" }Errores
NAME_TAKEN(409): ya hay una etiqueta activa con ese nombre.FORBIDDEN(403): tu rol no puede escribir.
GET /talent/tags/vocabulary
/talent/tags/vocabularyDevuelve las etiquetas activas del workspace por nombre, sin conteos: lo que sirve para sugerir etiquetas mientras alguien escribe.
Pagina: devuelve { rows, total, page, pageSize } con page (desde 1) y pageSize (hasta 200, default 50). Ver paginación.
curl "https://app.reclee.com/api/v1/talent/tags/vocabulary?pageSize=200" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{ "id": "4a5b6c7d-8e9f-4a0b-9c1d-2e3f4a5b6c71", "name": "inglés nativo", "color": "blue" }
],
"total": 1,
"page": 1,
"pageSize": 200
}PATCH /talent/tags/{tagId}
/talent/tags/{tagId}Renombra, cambia el color, archiva o recupera una etiqueta. Manda sólo lo que cambia; al menos un campo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| tagId | uuid | Sí | Id de la etiqueta. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Opcional | Nuevo nombre, de 1 a 60 caracteres. |
| color | string | null | Opcional | Nuevo color, hasta 20 caracteres; null lo quita. |
| archived | boolean | Opcional | true la archiva (sale de las sugerencias, quien la lleva la conserva); false la recupera. |
curl -X PATCH "https://app.reclee.com/api/v1/talent/tags/4a5b6c7d-8e9f-4a0b-9c1d-2e3f4a5b6c71" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "archived": true }'Respuesta
{ "id": "4a5b6c7d-8e9f-4a0b-9c1d-2e3f4a5b6c71", "name": "inglés nativo", "color": "blue" }Errores
INVALID(400): body vacío.NAME_TAKEN(409): otra etiqueta ya usa ese nombre.NOT_FOUND(404): la etiqueta no existe en este workspace.
Para escribir con una acción: update_tag.
DELETE /talent/tags/{tagId}
/talent/tags/{tagId}Una API key no borra etiquetas: borrarla desetiquetaría a todos de golpe. Contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_tag" }]. Para sacarla de circulación, archívala con PATCH /talent/tags/{tagId} y { "archived": true }, o con POST /actions/update_tag.
Notas
Las notas son texto libre que el equipo escribe sobre una persona. Se crean y se listan desde el perfil (/profiles/{profileId}/notes); aquí se corrigen. Sólo el autor puede editar su nota, y una nota nunca se borra.
PATCH /talent/notes/{noteId}
/talent/notes/{noteId}Reemplaza el texto de una nota tuya. El texto plano se guarda como texto enriquecido (cada párrafo, un <p>); si mandas HTML, se sanea.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| noteId | uuid | Sí | Id de la nota. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| body | string | Sí | Texto nuevo, de 1 a 20000 caracteres. |
curl -X PATCH "https://app.reclee.com/api/v1/talent/notes/7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e03" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "body": "Prefiere trabajo remoto. Disponible desde diciembre." }'Respuesta
{
"id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e03",
"profileId": "b7e2c1d4-5a6f-4b3c-8d2e-1f0a9b8c7d61",
"authorId": "8d2e4f6a-1b3c-4d5e-8f9a-0b1c2d3e4f50",
"authorName": "Lucía Méndez",
"body": "<p>Prefiere trabajo remoto. Disponible desde diciembre.</p>",
"createdAt": "2026-10-20T09:12:44.000Z",
"updatedAt": "2026-10-22T10:30:02.000Z"
}Errores
INVALID(400): texto vacío después de sanearlo.NOT_FOUND(404): la nota no existe o no es tuya.
Para escribir con una acción: update_note.
DELETE /talent/notes/{noteId}
/talent/notes/{noteId}Una nota se corrige, no se borra. Contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_note" }]. Usa PATCH /talent/notes/{noteId} o POST /actions/update_note.
Mantenimiento
Dos rutas de mantenimiento que guardan una copia propia de imágenes que solo tienen el link original del proveedor de datos (que suele vencer). No consumen créditos, pero requieren asiento (rol OWNER o RECRUITER). No las necesitas para integrar: Reclee las procesa solo.
POST /talent/avatars/backfill
/talent/avatars/backfillIntenta guardar la foto de hasta 50 personas que solo tienen el link del proveedor, empezando por las enriquecidas más recientemente. Cada persona se intenta una sola vez. Llámala de nuevo mientras attempted vuelva en 50. Sin body.
curl -X POST https://app.reclee.com/api/v1/talent/avatars/backfill \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{ "attempted": 50, "stored": 7 }stored puede ser mucho menor que attempted: buena parte de los links ya vienen vencidos.
POST /talent/logos/backfill
/talent/logos/backfillLo mismo para los logos: intenta hasta 50 de empresas y hasta 50 de instituciones educativas por llamada. Sin body.
curl -X POST https://app.reclee.com/api/v1/talent/logos/backfill \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{ "attempted": 100, "stored": 41 }