Importar CVs
Sube uno o muchos CVs directo al almacenamiento de Reclee, sigue la importación y resuelve los posibles duplicados.
Reclee lee cada CV, crea la persona en tu talent pool (o le agrega una versión nueva de CV si ya estaba) y marca los posibles duplicados para revisar. Los archivos no pasan por la API: pides URLs firmadas, subes los bytes directo a cada una y sigues la importación con un jobId.
Uso de IA
Leer un CV consume uso de IA del mes, a medida que se procesa cada archivo; por eso cost.billedLater viene en true. Un archivo que tu workspace ya tenía (mismo contenido) no se sube, no se lee y no se cobra. Ver Créditos y uso.
export RECLEE_API="https://app.reclee.com/api/v1"
export RECLEE_API_KEY="rcl_..."Límites: hasta 100 archivos por llamada, PDF o DOCX, de hasta 4 MB cada uno.
Pide las URLs de subida
upload_cv recibe la lista de archivos con su nombre, tamaño en bytes, tipo y el SHA-256 de su contenido en hexadecimal (minúsculas). Para un solo CV, manda una lista de un elemento; con profileId, el CV se agrega a una persona que ya está en tu pool.
SHA=$(sha256sum martina-ocampo.pdf | cut -d' ' -f1)
SIZE=$(stat -c%s martina-ocampo.pdf)
curl -s -X POST "$RECLEE_API/actions/upload_cv" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6e8a0c2d-7f9b-4d1e-8a3c-5b7d9f1b3e4f" \
-d "{
\"files\": [
{ \"name\": \"martina-ocampo.pdf\", \"size\": $SIZE, \"type\": \"application/pdf\", \"sha256\": \"$SHA\" }
]
}"{
"data": {
"jobId": "7f9b1d3e-8a0c-4e2f-9b4d-6c8e0a2c4f5a",
"files": [
{ "position": 0, "fileName": "martina-ocampo.pdf", "uploadUrl": "https://…", "alreadyHere": false, "profileId": null },
{ "position": 1, "fileName": "tomas-bianchi.docx", "uploadUrl": null, "alreadyHere": true, "profileId": "8f0b2d4e-9a1c-4d3e-8f5b-7c9d1e3f5a6d" }
]
},
"links": [ … ],
"next": { "missing": [], "suggestions": [ { "tool": "get_cv_import", "input": { "jobId": "7f9b1d3e-8a0c-4e2f-9b4d-6c8e0a2c4f5a" } } ] },
"cost": { "aiUsagePct": 0, "teamUsagePct": 0, "credits": 0, "billedLater": true }
}files mantiene el orden en que los mandaste (position). Un archivo con alreadyHere: true ya estaba en tu workspace: no se sube y su profileId dice de quién es.
Errores en este paso
400 BAD_FILE: un archivo no cumple el tipo, el tamaño o el formato del hash.429 TOO_MANY: ya tienes demasiados archivos esperando o leyéndose; espera a que avance la importación.402 USAGE_WINDOWoUSAGE_EXHAUSTED: no queda uso de IA para leerlos.404 NOT_FOUND: elprofileIdno está en tu pool.
Sube cada archivo
Haz un PUT con los bytes del archivo a su uploadUrl, con su tipo como Content-Type. Cada URL vale dos horas. No hay paso de confirmación: Reclee detecta solo lo que llegó.
curl -s -X PUT "<uploadUrl>" \
-H "Content-Type: application/pdf" \
--data-binary @martina-ocampo.pdfLa URL de subida no lleva tu API key: no mandes el header Authorization ahí.
Sigue la importación
La importación avanza sola en el servidor, unos pocos archivos por minuto. Consulta GET /talent/pool/cvs/jobs/{jobId} hasta que finished sea true:
curl -s "$RECLEE_API/talent/pool/cvs/jobs/7f9b1d3e-8a0c-4e2f-9b4d-6c8e0a2c4f5a" \
-H "Authorization: Bearer $RECLEE_API_KEY"{
"jobId": "7f9b1d3e-8a0c-4e2f-9b4d-6c8e0a2c4f5a",
"finished": true,
"total": 2,
"done": 2,
"failed": 0,
"created": 1,
"exists": 0,
"noIdentifier": 0,
"alreadyHere": 1,
"waitingFor": null,
"items": [
{
"id": "0c2e4a6b-1d3f-4a5b-8c7e-9f1a3b5d7e8a",
"position": 0,
"fileName": "martina-ocampo.pdf",
"status": "DONE",
"outcome": "CREATED",
"profileId": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52",
"error": null,
"duplicateOf": { "profileId": "1d3f5b7c-2e4a-4b6c-9d8f-0a2b4c6d8e9b", "name": "Martina Ocampo" }
}
]
}(Extracto.) Cómo leer cada ítem:
status:PENDING,RUNNING,DONEoFAILED.outcome(cuando terminó):CREATED(persona nueva),EXISTS(versión nueva del CV de alguien que ya estaba),NO_IDENTIFIERoALREADY_HERE.error(cuando falló): por ejemploNOT_UPLOADED(no llegó ningún archivo mientras la URL estaba vigente),NOT_A_CV,NO_TEXToUNREADABLE.duplicateOf: posible duplicado de otra persona de tu pool. Revísalo en el paso siguiente.waitingFor: si hay archivos esperando porque se agotó el uso, el código que lo frena (por ejemploUSAGE_EXHAUSTED); si no,null.
Por MCP, la tool get_cv_import con el jobId devuelve lo mismo resumido, con people[].possibleDuplicate.
Revisa los posibles duplicados
Cuando un CV parece ser de alguien que ya estaba, Reclee abre una revisión en vez de mezclar a las dos personas. Lístalas con GET /talent/pool/identity-reviews:
curl -s "$RECLEE_API/talent/pool/identity-reviews?page=1&pageSize=20" \
-H "Authorization: Bearer $RECLEE_API_KEY"{
"rows": [
{
"id": "2e4a6c8d-3f5b-4c7d-8e9a-1b3c5d7f9a0c",
"email": "martina.ocampo@kuanta.io",
"createdAt": "2026-10-22T16:30:00.000Z",
"people": [
{ "profileId": "1d3f5b7c-2e4a-4b6c-9d8f-0a2b4c6d8e9b", "name": "Martina Ocampo", "headline": "Backend Engineer", "enriched": true, "hasPublicProfile": true },
{ "profileId": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52", "name": "Martina Ocampo", "headline": null, "enriched": false, "hasPublicProfile": false }
]
}
],
"total": 1,
"page": 1,
"pageSize": 20
}(Extracto.) La persona que quedaría es la primera. Para ver qué se movería antes de decidir, POST /talent/pool/merge/preview con { "keepProfileId", "mergeProfileId" }.
Resuelve: unir o separar
resolve_merge_candidate une a las dos personas (decision: "MERGE", el default) o marca que no son la misma (decision: "NOT_SAME_PERSON", con el reviewId).
curl -s -X POST "$RECLEE_API/actions/resolve_merge_candidate" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"decision": "MERGE",
"keepProfileId": "1d3f5b7c-2e4a-4b6c-9d8f-0a2b4c6d8e9b",
"mergeProfileId": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52"
}'{
"data": {
"keep": "1d3f5b7c-2e4a-4b6c-9d8f-0a2b4c6d8e9b",
"merged": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52",
"applications": 1,
"withdrawnApplications": 0,
"notes": 0,
"tags": 2,
"bookmarks": 0,
"contacts": 1,
"cvs": 1,
"attachments": 0,
"identityReviews": 1
},
"links": [ … ],
"next": {
"missing": [],
"suggestions": [
{ "tool": "get_profile", "input": { "profileId": "1d3f5b7c-2e4a-4b6c-9d8f-0a2b4c6d8e9b" } },
{ "tool": "list_merge_candidates" }
]
}
}Los números cuentan lo que pasó de una persona a la otra. Quién queda lo decide una regla (la que tiene LinkedIn; si no, la más antigua), así que el orden de los dos ids no importa. Errores: 409 BOTH_HIRED y 409 TWO_PUBLIC_PROFILES (dos perfiles públicos distintos no se unen).
Para separarlas:
curl -s -X POST "$RECLEE_API/actions/resolve_merge_candidate" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "decision": "NOT_SAME_PERSON", "reviewId": "2e4a6c8d-3f5b-4c7d-8e9a-1b3c5d7f9a0c" }'Reintentos
Con el mismo Idempotency-Key, repetir upload_cv devuelve la primera respuesta (mismo jobId, mismas URLs). Sin la key, lo que ya subiste vuelve como alreadyHere y lo que no, en una importación nueva. Las rutas viejas POST /talent/pool/cvs y POST /talent/pool/cvs/batch contestan 410 GONE y nombran la acción que las reemplaza.