Reclee

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

GET/talent/pool

Lista 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

CampoTipoRequeridoDescripción
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas por página, de 1 a 200. Default 50.
sortenumOpcionalOrden: 'added' (última incorporación primero, default), 'updated' (último perfil actualizado) o 'name'.
searchstringOpcionalTexto libre, hasta 200 caracteres. Cada palabra tiene que aparecer en algún lado.
titlesstring[] (separado por comas)OpcionalPuestos (coincidencia parcial). Hasta 20 valores.
companiesstring[] (separado por comas)OpcionalEmpresas (coincidencia parcial). Hasta 20 valores.
locationsstring[] (separado por comas)OpcionalUbicaciones (coincidencia parcial). Hasta 20 valores.
skillsstring[] (separado por comas)OpcionalSkills. Hasta 20. Por default la persona tiene que tenerlas todas (ALL).
languagesstring[] (separado por comas)OpcionalIdiomas. Hasta 20. Por default ALL.
institutionsstring[] (separado por comas)OpcionalInstituciones educativas. Hasta 20.
certificationsstring[] (separado por comas)OpcionalCertificaciones. Hasta 20.
tagsstring[] (separado por comas)OpcionalNombres de etiquetas. Hasta 20.
bookmarkIdsuuid[] (separado por comas)OpcionalLimita a las personas de estas listas. Hasta 50.
jobPostIdsuuid[] (separado por comas)OpcionalPersonas que pasaron por estas vacantes. Hasta 50.
importJobIdsuuid[] (separado por comas)OpcionalPersonas que archivó una carga de CVs. Hasta 20.
experienceMinintegerOpcionalAños de experiencia mínimos, de 0 a 60.
experienceMaxintegerOpcionalAños de experiencia máximos, de 0 a 60.
freshnessenumOpcionalAntigüedad del perfil público: 'FRESH' (menos de 90 días), 'AGING' (hasta un año) o 'STALE' (más de un año).
contactStatusenumOpcional'doNotContact', 'reachable' o 'unreachable'.
doNotContactbooleanOpcional'true' o 'false': con o sin la marca de no contactar.
relationStatusesenum[] (separado por comas)OpcionalRelación con tus vacantes: 'available', 'inProcess', 'placed', 'discarded'. También existe relationStatus con un solo valor.
originsenum[] (separado por comas)OpcionalCómo entró al pool: 'SOURCED', 'MANUAL', 'CV', 'APPLIED'. También existe origin con un solo valor.
profileKindsenum[] (separado por comas)OpcionalQué perfil tiene: 'public' (el de LinkedIn), 'own' (el que escribió tu workspace) o 'both'.
addedFromstring (ISO 8601)OpcionalIncorporados desde este instante (inclusive). Con zona horaria.
addedTostring (ISO 8601)OpcionalIncorporados hasta este instante (inclusive). Con zona horaria.
<lista>OpenumOpcionalOperador 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, o ALL en una lista de un solo valor.

DELETE /talent/pool

DELETE/talent/pool

Una 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

POST/talent/pool/details

Lee 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

CampoTipoRequeridoDescripción
profileIdsuuid[]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

GET/talent/pool/facets

El 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

GET/talent/pool/export

Descarga 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

CampoTipoRequeridoDescripción
profileIdsuuid[] (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.csv

Columnas, 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): falta profileIds, 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

GET/talent/pool/screen

Lo 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}

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

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

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

GET/talent/pool/{profileId}/profile

La 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

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

GET/talent/pool/{profileId}/screen

Lo 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

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

GET/talent/pool/{profileId}/removal

Vista 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

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

GET/talent/pool/{profileId}/own

Todas 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

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

POST/talent/pool/{profileId}/own

Escribe 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Body

CampoTipoRequeridoDescripción
baseVersioninteger | nullOpcionalLa 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.
headlinestringOpcionalHasta 200 caracteres.
locationstringOpcionalHasta 200. Omitido conserva la de arriba.
summarystringOpcionalHasta 4000.
verifiedLanguagesstringOpcionalIdiomas que alguien de tu equipo verificó, texto libre, hasta 400.
languagesstring[]OpcionalIdiomas declarados, hasta 20. Omitido conserva los de arriba.
linksstring[] (URL)OpcionalLinkedIn, portfolio, GitHub, etc. Hasta 10.
profileLanguagestringOpcionalIdioma del perfil en ISO 639-1 (por ejemplo 'es'). Cadena vacía lo borra.
candidateNotesstringOpcionalLo que dijo la persona sobre sí misma, hasta 4000. Cadena vacía lo borra.
skillsstring[]OpcionalHasta 60. Default [].
positionsobject[]OpcionalHasta 30 puestos: title y organizationName obligatorios; description, isCurrent, startYear, startMonth, endYear, endMonth opcionales.
educationobject[]OpcionalHasta 20: schoolName obligatorio; degree, fieldOfStudy, startYear, endYear opcionales.
certificationsobject[]OpcionalHasta 30: name obligatorio; authority, url, issuedYear opcionales.
projectsobject[]OpcionalHasta 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 de baseVersion. Vuelve a leer con GET y vuelve a escribir.

Para escribir con la acción equivalente: update_profile.

PATCH /talent/pool/{profileId}/own

PATCH/talent/pool/{profileId}/own

Escribe 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Body

CampoTipoRequeridoDescripción
baseVersioninteger | nullSíLa versión que está arriba (null si tu workspace todavía no escribió ninguna).
headlinestring | nullOpcionalHasta 200. null lo borra.
locationstring | nullOpcionalHasta 200. null lo borra.
summarystring | nullOpcionalHasta 4000. null lo borra.
verifiedLanguagesstring | nullOpcionalHasta 400. null lo borra.
languagesstring[]OpcionalReemplaza la lista. Hasta 20.
skillsstring[]OpcionalReemplaza la lista. Hasta 60.
addPositions / removePositionsobject[] / integer[]OpcionalPuestos a agregar (misma forma que en POST) e índices (desde 0) a quitar.
addEducation / removeEducationobject[] / integer[]OpcionalEstudios a agregar e índices a quitar.
addCertifications / removeCertificationsobject[] / integer[]OpcionalCertificaciones a agregar e índices a quitar.
addProjects / removeProjectsobject[] / integer[]OpcionalProyectos 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): baseVersion ya no es la versión de arriba.
  • CAREER_ENTRY_NOT_FOUND (404): un índice de remove… 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

POST/talent/pool/{profileId}/linkedin

Le 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Body

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

ValorQué pasó
linkedSe asignó y se trajo el perfil.
mergedEl handle era de un perfil fuera de tu pool: tu persona se unió a ese perfil. profileId dice quién queda.
notFoundSe asignó, pero no hay perfil público con ese handle. El handle queda.
alreadyLa persona ya tenía ese mismo handle.
hasOtherLa persona tiene otro handle; cambiarlo es una corrección, no un link.
takenOtra 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

PUT/talent/pool/{profileId}/do-not-contact

Marca 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona.

Body

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

true

Errores

  • 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

POST/talent/pool/save

Guarda 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

CampoTipoRequeridoDescripción
profileIdsuuid[]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

POST/talent/pool/manual

Agrega 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

CampoTipoRequeridoDescripción
namestringSíNombre completo, hasta 200 caracteres.
emailstring (email)OpcionalHasta 320. Obligatorio si no hay linkedin.
linkedinstringOpcionalURL de un perfil personal de LinkedIn, hasta 300. Obligatorio si no hay email.
phonestringOpcionalHasta 40.
headlinestringOpcionalHasta 200.
titlestringOpcionalPuesto actual, hasta 200. Obligatorio si mandas company.
companystringOpcionalEmpresa actual, hasta 200.
locationstringOpcionalHasta 200.
summarystringOpcionalHasta 4000.
skillsstring[]OpcionalHasta 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 hay company sin title.
  • 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

GET/talent/pool/manual/duplicate

Antes 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

CampoTipoRequeridoDescripción
emailstringOpcionalEmail a buscar, hasta 320.
linkedinstringOpcionalURL 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

POST/talent/pool/linkedin

Trae 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

CampoTipoRequeridoDescripción
urlsstring[]SíEntre 1 y 1000 líneas, cada una una URL o handle de LinkedIn de hasta 300 caracteres.
refreshbooleanOpcionalVolver 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

POST/talent/pool/sheet/columns

Lee 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)

CampoTipoRequeridoDescripción
filefileSí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 .xls anterior a 2007, está vacía o no se pudo leer.

POST /talent/pool/sheet

POST/talent/pool/sheet

Importa 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)

CampoTipoRequeridoDescripción
filefileSíLa planilla, hasta 4 MB. Se importan hasta 300 filas.
mappingsstring (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).
blocksstring (JSON)OpcionalArray 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.
dedupeOffstring (JSON)OpcionalColumnas identificadoras que NO deduplican: subconjunto de 'email', 'personalEmail', 'linkedin'. Al menos un identificador mapeado tiene que seguir deduplicando.
linkPublicProfilestringOpcional'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 en details).
  • INVALID_JSON (400): mappings, blocks o dedupeOff no 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

POST/talent/pool/tags

Pone 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

CampoTipoRequeridoDescripción
profileIdsuuid[]SíEntre 1 y 500 ids.
namestringSí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

DELETE/talent/pool/tags

Quita 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

CampoTipoRequeridoDescripción
profileIdsuuid[]SíEntre 1 y 500 ids.
namestringSí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

PUT/talent/pool/do-not-contact

Marca «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

CampoTipoRequeridoDescripción
profileIdsuuid[]SíEntre 1 y 500 ids.
notestringSí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

POST/talent/pool/removal

Vista 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

CampoTipoRequeridoDescripción
profileIdsuuid[]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

GET/talent/pool/identity-reviews

Los 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

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

GET/talent/pool/identity-reviews/count

Cuá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

3

GET /talent/pool/identity-reviews/{reviewId}

GET/talent/pool/identity-reviews/{reviewId}

Un caso abierto con sus personas. Misma forma que una fila de la lista.

Parámetros de ruta

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

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

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

POST/talent/pool/merge/preview

Qué 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

CampoTipoRequeridoDescripción
keepProfileIduuidSíUna de las dos personas.
mergeProfileIduuidSí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

POST/talent/pool/merge

Fusiona 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

CampoTipoRequeridoDescripción
keepProfileIduuidSíUna de las dos personas.
mergeProfileIduuidSí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) y TWO_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

POST/talent/pool/cvs/jobs

Abre 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

CampoTipoRequeridoDescripción
filesobject[]SíEntre 1 y 100 archivos.
files[].namestringSíNombre del archivo, de 1 a 500 caracteres.
files[].sizeintegerSíTamaño en bytes, de 1 a 4194304 (4 MB).
files[].typeenumSí'application/pdf' o 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' (DOCX).
files[].sha256stringSíSHA-256 del archivo en hexadecimal, 64 caracteres en minúscula.
profileIduuidOpcionalLa persona del pool a la que pertenecen los CVs, si ya la conoces. Sin este campo, cada CV crea o encuentra a su persona.
linkPublicProfilebooleanOpcionalSi 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.pdf

Consume 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): el profileId no 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}

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

CampoTipoRequeridoDescripción
jobIduuidSí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
    }
  ]
}
  • status de cada archivo: PENDING, RUNNING, DONE o FAILED.
  • 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) o ALREADY_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, …), o null mientras se lee.

Errores

  • NOT_FOUND (404): la carga no existe en este workspace.

GET /talent/pool/cvs/jobs/running

GET/talent/pool/cvs/jobs/running

La 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

null

POST /talent/pool/cvs/jobs/{jobId}/tick

POST/talent/pool/cvs/jobs/{jobId}/tick

Retirada. 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

POST/talent/pool/cvs

Retirada. 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

POST/talent/pool/cvs/batch

Retirada, 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

GET/talent/pool/cvs/{cvId}/url

Devuelve 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

CampoTipoRequeridoDescripción
cvIduuidSíEl id del CV.

Parámetros de query

CampoTipoRequeridoDescripción
downloadbooleanOpcional'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

GET/talent/pool/attachments/{attachmentId}/url

Devuelve 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

CampoTipoRequeridoDescripción
attachmentIduuidSíEl id del adjunto.

Parámetros de query

CampoTipoRequeridoDescripción
downloadbooleanOpcional'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:

  1. 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).
  2. Revela a una persona con POST /talent/contacts/reveal, o a varias (o a una longlist entera) con POST /talent/contacts/reveal/batch.
  3. Consulta el estado con POST /talent/contacts/states o, para un lote, con GET /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

POST/talent/contacts/reveal/estimate

Calcula lo que costaría un reveal sin gastar nada. Recibe el mismo body que POST /talent/contacts/reveal/batch.

Body

CampoTipoRequeridoDescripción
profileIdsuuid[]OpcionalEntre 1 y 50 personas del pool. Envía profileIds o longlistId, no los dos.
longlistIduuidOpcionalUna longlist entera. Envía profileIds o longlistId, no los dos.
typesenum[]SíAl menos uno de 'EMAIL_WORK', 'EMAIL_PERSONAL', 'PHONE'. Los repetidos se cuentan una vez.
overridebooleanOpcionalSe 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
}
  • requested es personas × tipos; toBuy es 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) y withoutLinkedin (no se puede buscar).
  • doNotContact: cuántas personas quedan afuera por estar marcadas «No contactar». No entran en toBuy ni 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 es false, el reveal fallará con NO_CREDITS.
  • fitsInBalance / balanceUnchecked: si el proveedor de datos puede atenderlo ahora. Con false / true respectivamente, el lote se rechaza con PROVIDER_NO_CREDITS.
  • exceedsCap: el lote supera el tope por lote; ver TOO_LARGE en 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

POST/talent/contacts/reveal

Revela 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona del pool.
typesenum[]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

POST/talent/contacts/reveal/batch

Revela 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

CampoTipoRequeridoDescripción
profileIdsuuid[]OpcionalEntre 1 y 50 personas del pool. Envía profileIds o longlistId, no los dos.
longlistIduuidOpcionalUna longlist entera. Envía profileIds o longlistId, no los dos.
typesenum[]SíAl menos uno de 'EMAIL_WORK', 'EMAIL_PERSONAL', 'PHONE'.
overridebooleanOpcionalSupera 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. Un OWNER puede repetirlo con override: 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}

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

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

POST/talent/contacts/states

Lo 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

CampoTipoRequeridoDescripción
profileIdsuuid[]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

POST/talent/pool/{profileId}/contacts

Agrega 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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona del pool.

Body

CampoTipoRequeridoDescripción
typeenumOpcional'EMAIL_WORK', 'EMAIL_PERSONAL' o 'PHONE'. Sin type, value tiene que ser un email y el tipo (laboral o personal) se deduce del dominio.
valuestringSí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}

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

CampoTipoRequeridoDescripción
profileIduuidSíLa persona del pool.
contactIduuidSíEl contacto a corregir.

Body

Igual que en POST /talent/pool/{profileId}/contacts:

CampoTipoRequeridoDescripción
typeenumOpcional'EMAIL_WORK', 'EMAIL_PERSONAL' o 'PHONE'. Sin type, value tiene que ser un email.
valuestringSí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}

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

GET/talent/profiles

El 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

CampoTipoRequeridoDescripción
profileIdsstring[] (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): falta profileIds.

POST /talent/profiles/enrich/plan

POST/talent/profiles/enrich/plan

Lo que haría POST /talent/profiles/enrich con el mismo body, sin gastar nada.

Body

CampoTipoRequeridoDescripción
profileIdsuuid[]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

POST/talent/profiles/enrich

Enriquece 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

CampoTipoRequeridoDescripción
profileIdsuuid[]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; respeta Retry-After.
  • SEAT_REQUIRED (403): la key pertenece a alguien sin asiento.

Equivalente como acción: enrich_profile.

POST /talent/profiles/match

POST/talent/profiles/match

Filtra 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

CampoTipoRequeridoDescripción
profileIdsuuid[]SíLas personas a filtrar, hasta 5000. Solo se lee este alcance, no el resto del pool.
filtersobjectSíLos filtros. Puede ser un objeto vacío.
filters.skillsstring[]OpcionalHasta 50 nombres de skill.
filters.languagesobject[]OpcionalHasta 20 idiomas: { name, level }. level es opcional: 'ELEMENTARY', 'LIMITED_WORKING', 'PROFESSIONAL_WORKING', 'FULL_PROFESSIONAL' o 'NATIVE_OR_BILINGUAL'.
filters.emailstringOpcionalParte de un email guardado, hasta 320 caracteres.
filters.phonestringOpcionalParte de un teléfono guardado, hasta 40 caracteres.
filters.bookmarkIdsuuid[]OpcionalHasta 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

GET/talent/bookmarks

Devuelve 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

POST/talent/bookmarks

Crea 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

CampoTipoRequeridoDescripción
namestringSíNombre de la lista, de 1 a 80 caracteres.
descriptionstring | nullOpcionalHasta 280 caracteres. Default: null.
isPrivatebooleanOpcionalDefault: true. La lista nace privada salvo que pidas lo contrario.
profileIdsuuid[]OpcionalHasta 500 personas para archivar en la lista al crearla. Sólo entran las que están en el pool.
iduuidOpcionalId 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, un VIEWER).
  • NOT_FOUND (404): mandaste profileIds y ninguno está en el pool. No se crea la lista.

Para escribir con una acción: create_bookmark.

GET /talent/bookmarks/{bookmarkId}

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

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

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

CampoTipoRequeridoDescripción
bookmarkIduuidSíId de la lista.

Body

CampoTipoRequeridoDescripción
namestringOpcionalDe 1 a 80 caracteres.
descriptionstring | nullOpcionalHasta 280 caracteres; null la borra.
isPrivatebooleanOpcionalfalse 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}

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

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

true

Errores

  • NOT_FOUND (404): la lista no existe o no es tuya.

Para escribir con una acción: delete_bookmark.

POST /talent/bookmarks/{bookmarkId}/profiles

POST/talent/bookmarks/{bookmarkId}/profiles

Agrega 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

CampoTipoRequeridoDescripción
bookmarkIduuidSíId de la lista.

Body

CampoTipoRequeridoDescripción
profileIdsuuid[]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

1

Errores

  • 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

DELETE/talent/bookmarks/{bookmarkId}/profiles

Saca personas de la lista (no del pool). Lleva body JSON, igual que el POST. Devuelve cuántas salieron.

Parámetros de ruta

CampoTipoRequeridoDescripción
bookmarkIduuidSíId de la lista.

Body

CampoTipoRequeridoDescripción
profileIdsuuid[]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

1

Para escribir con una acción: remove_from_bookmark.

POST /talent/bookmarks/{bookmarkId}/longlists

POST/talent/bookmarks/{bookmarkId}/longlists

Vuelca 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

CampoTipoRequeridoDescripción
bookmarkIduuidSíId de la lista.

Body

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

37

Errores

  • 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

POST/talent/bookmarks/membership

Para 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

CampoTipoRequeridoDescripción
profileIdsuuid[]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

GET/talent/searches

Lista las búsquedas del workspace, de la más nueva a la más vieja.

Parámetros de query

CampoTipoRequeridoDescripción
threadIduuidOpcionalSólo las búsquedas lanzadas desde esa conversación de Ask Reclee.
pageintegerOpcionalPágina, desde 1. Default: 1.
pageSizeintegerOpcionalHasta 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

POST/talent/searches

Ejecuta 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

CampoTipoRequeridoDescripción
queryobjectSíLos filtros de la búsqueda (tabla siguiente). Al menos uno es obligatorio.
replacesIduuidOpcionalLa búsqueda que esta refina: la nueva toma el número siguiente de esa cadena.

Filtros de query

CampoTipoRequeridoDescripción
titlestringOpcionalCargo actual. Mínimo 3 caracteres.
headlinestringOpcionalTexto del titular del perfil. Mínimo 3 caracteres.
skillsstring[]OpcionalSkills, hasta 20.
geoCountryCodestringOpcionalPaís, código ISO de 2 letras (por ejemplo 'ar'). Se guarda en minúsculas.
geoCitystringOpcionalCiudad, mínimo 3 caracteres. Exige geoCountryCode.
experienceMinYearsintegerOpcionalAños mínimos de experiencia, de 1 a 60.
speaksLanguagestring[]OpcionalIdiomas que habla, hasta 20.
industrystring[]OpcionalIndustrias, hasta 20, de al menos 3 caracteres cada una.
organizationSlugsstring[]OpcionalEmpresas (identificador corto de la empresa), hasta 20.
educationLevelenumOpcionalNivel educativo: 'phd', 'master', 'bachelor' o 'associate'.
certificationsstring[]OpcionalCertificaciones, hasta 20.
excludeTitlesstring[]OpcionalCargos a excluir, hasta 20, de al menos 3 caracteres.
excludeOrganizationSlugsstring[]OpcionalEmpresas a excluir, hasta 20.
excludeIndustriesstring[]OpcionalIndustrias 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, o geoCity sin geoCountryCode.
  • SEAT_REQUIRED (403): tu rol no tiene asiento.
  • NOT_FOUND (404): replacesId no es una búsqueda de este workspace.
  • USAGE_WINDOW, USAGE_EXHAUSTED, NO_CREDITS y 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}

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

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

POST/talent/searches/{searchId}/next

Trae 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

CampoTipoRequeridoDescripción
searchIduuidSí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 en POST /talent/searches.

Para escribir con una acción: load_more_talent.

POST /talent/searches/propose

POST/talent/searches/propose

Convierte 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

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

GET/talent/tags

Devuelve 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

POST/talent/tags

Crea una etiqueta. Si el nombre pertenece a una etiqueta archivada, la recupera en lugar de crear otra. Acepta Idempotency-Key (ver idempotencia).

Body

CampoTipoRequeridoDescripción
namestringSíDe 1 a 60 caracteres.
colorstring | nullOpcionalColor 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

GET/talent/tags/vocabulary

Devuelve 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}

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

CampoTipoRequeridoDescripción
tagIduuidSíId de la etiqueta.

Body

CampoTipoRequeridoDescripción
namestringOpcionalNuevo nombre, de 1 a 60 caracteres.
colorstring | nullOpcionalNuevo color, hasta 20 caracteres; null lo quita.
archivedbooleanOpcionaltrue 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}

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

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

CampoTipoRequeridoDescripción
noteIduuidSíId de la nota.

Body

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

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

POST/talent/avatars/backfill

Intenta 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

POST/talent/logos/backfill

Lo 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 }

En esta página

PoolGET /talent/poolDELETE /talent/poolPOST /talent/pool/detailsGET /talent/pool/facetsGET /talent/pool/exportGET /talent/pool/screenUna persona del poolGET /talent/pool/{profileId}DELETE /talent/pool/{profileId}GET /talent/pool/{profileId}/profileGET /talent/pool/{profileId}/screenGET /talent/pool/{profileId}/removalGET /talent/pool/{profileId}/ownPOST /talent/pool/{profileId}/ownPATCH /talent/pool/{profileId}/ownPOST /talent/pool/{profileId}/linkedinPUT /talent/pool/{profileId}/do-not-contactAgregar personasPOST /talent/pool/savePOST /talent/pool/manualGET /talent/pool/manual/duplicatePOST /talent/pool/linkedinPOST /talent/pool/sheet/columnsPOST /talent/pool/sheetEtiquetas, no contactar y salidasPOST /talent/pool/tagsDELETE /talent/pool/tagsPUT /talent/pool/do-not-contactPOST /talent/pool/removalDuplicados y fusionesGET /talent/pool/identity-reviewsGET /talent/pool/identity-reviews/countGET /talent/pool/identity-reviews/{reviewId}DELETE /talent/pool/identity-reviews/{reviewId}POST /talent/pool/merge/previewPOST /talent/pool/mergeCVs y adjuntosPOST /talent/pool/cvs/jobsGET /talent/pool/cvs/jobs/{jobId}GET /talent/pool/cvs/jobs/runningPOST /talent/pool/cvs/jobs/{jobId}/tickPOST /talent/pool/cvsPOST /talent/pool/cvs/batchGET /talent/pool/cvs/{cvId}/urlGET /talent/pool/attachments/{attachmentId}/urlContactosPOST /talent/contacts/reveal/estimatePOST /talent/contacts/revealPOST /talent/contacts/reveal/batchGET /talent/contacts/batches/{batchId}POST /talent/contacts/statesPOST /talent/pool/{profileId}/contactsPATCH /talent/pool/{profileId}/contacts/{contactId}DELETE /talent/pool/{profileId}/contacts/{contactId}Perfiles y enriquecimientoGET /talent/profilesPOST /talent/profiles/enrich/planPOST /talent/profiles/enrichPOST /talent/profiles/matchListasGET /talent/bookmarksPOST /talent/bookmarksGET /talent/bookmarks/{bookmarkId}PATCH /talent/bookmarks/{bookmarkId}DELETE /talent/bookmarks/{bookmarkId}POST /talent/bookmarks/{bookmarkId}/profilesDELETE /talent/bookmarks/{bookmarkId}/profilesPOST /talent/bookmarks/{bookmarkId}/longlistsPOST /talent/bookmarks/membershipBúsquedas de talentoGET /talent/searchesPOST /talent/searchesGET /talent/searches/{searchId}POST /talent/searches/{searchId}/nextPOST /talent/searches/proposeVocabulario de etiquetasGET /talent/tagsPOST /talent/tagsGET /talent/tags/vocabularyPATCH /talent/tags/{tagId}DELETE /talent/tags/{tagId}NotasPATCH /talent/notes/{noteId}DELETE /talent/notes/{noteId}MantenimientoPOST /talent/avatars/backfillPOST /talent/logos/backfill