Reclee

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_WINDOW o USAGE_EXHAUSTED: no queda uso de IA para leerlos.
  • 404 NOT_FOUND: el profileId no 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.pdf

La 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, DONE o FAILED.
  • outcome (cuando terminó): CREATED (persona nueva), EXISTS (versión nueva del CV de alguien que ya estaba), NO_IDENTIFIER o ALREADY_HERE.
  • error (cuando falló): por ejemplo NOT_UPLOADED (no llegó ningún archivo mientras la URL estaba vigente), NOT_A_CV, NO_TEXT o UNREADABLE.
  • 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 ejemplo USAGE_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.

Siguientes pasos

En esta página