Gestionar el pipeline
Suma candidatos a una vacante, muévelos de etapa uno a uno o en lote, etiquétalos, coméntalos, descalifícalos y calcula su match score.
Esta guía trabaja sobre el pipeline de una vacante ya publicada: suma personas del talent pool, lista el pipeline, mueve candidatos entre etapas, los etiqueta y comenta, los descalifica o los restaura, y calcula su match score.
Necesitas el jobPostId de una vacante en estado ACTIVE (ver Publicar una vacante) y los profileId de personas de tu pool (GET /talent/pool o la acción search_talent).
export RECLEE_API="https://app.reclee.com/api/v1"
export RECLEE_API_KEY="rcl_..."
export JOB_POST_ID="3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90"Lee las etapas de la vacante
Cada movimiento pide el stageId de destino. Las etapas salen de GET /job-posts/{jobPostId}/pipeline, en orden; su name es null hasta que alguien las renombra, así que identifícalas por templateKey (SOURCED, SCREENING, INTERVIEW, SHORTLIST, HIRED).
curl -s "$RECLEE_API/job-posts/$JOB_POST_ID/pipeline" \
-H "Authorization: Bearer $RECLEE_API_KEY"{
"stages": [
{ "id": "a1c3e5f7-1b2d-4e6f-8a9b-0c1d2e3f4a51", "name": null, "templateKey": "SOURCED", "position": 1, "isLocked": true, "qualified": 0, "disqualified": 0, "withdrawn": 0 },
{ "id": "b2d4f6a8-2c3e-4f7a-9b0c-1d2e3f4a5b62", "name": null, "templateKey": "SCREENING", "position": 2, "isLocked": true, "qualified": 0, "disqualified": 0, "withdrawn": 0 },
{ "id": "c3e5a7b9-3d4f-4a8b-8c1d-2e3f4a5b6c73", "name": "Entrevista técnica", "templateKey": "INTERVIEW", "position": 3, "isLocked": false, "qualified": 0, "disqualified": 0, "withdrawn": 0 }
],
"candidates": [],
"activeRun": null,
"openGuaranteePlacementId": null
}(Extracto.)
Suma candidatos
add_to_job_post agrega personas del pool, por profileIds o por linkedinUrls (URL o handle de alguien que tu pool ya tiene), hasta 200 en total. Siempre entran QUALIFIED en la primera etapa y nunca llaman al proveedor de datos.
curl -s -X POST "$RECLEE_API/actions/add_to_job_post" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 5c2e8a14-7d3b-4f9a-8e6c-1b2d3f4a5c60" \
-d '{
"jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
"profileIds": ["6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52", "7b9d1f3a-8c0e-4f2a-9b4d-6e8f0a2b4c63"],
"linkedinUrls": ["https://www.linkedin.com/in/lucia-ferrer-dev"]
}'{
"data": {
"added": 2,
"already": 0,
"unknown": 0,
"blocked": 1,
"applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"],
"linkedin": [{ "linkedinUrl": "https://www.linkedin.com/in/lucia-ferrer-dev", "profileId": null }],
"notInPool": ["https://www.linkedin.com/in/lucia-ferrer-dev"]
},
"links": [ … ],
"next": {
"missing": [],
"suggestions": [
{ "tool": "enrich_profile", "input": { "linkedinUrls": ["https://www.linkedin.com/in/lucia-ferrer-dev"] } },
{ "tool": "run_match_score", "input": { "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90", "applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"] } },
{ "tool": "list_applications", "input": { "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90" } }
]
}
}applicationIdsson las postulaciones recién creadas: son los ids que usan los pasos siguientes.alreadycuenta a quienes ya estaban en el pipeline;unknown, perfiles que tu workspace no ve.blockedcuenta a personas marcadas como No contactar: nunca se agregan.notInPoollista las URLs que no están en tu pool.nextsugiere traerlas conenrich_profile, que sí consume uso.
Errores en este paso
409 JOB_POST_DRAFT: la vacante sigue en borrador; traemissingcon lo que le falta para publicarse.404 NOT_FOUND: ninguna de las personas está en tu pool; sugiereenrich_profile.
Lista el pipeline
GET /job-posts/{jobPostId}/applications devuelve una página de postulaciones, de la más nueva a la más vieja. Filtros: stageId, status (QUALIFIED, DISQUALIFIED, WITHDRAWN), origin (SOURCED, MANUAL, CAREER_SITE), labels (nombres separados por coma; la fila tiene que llevarlos todos), minScore (0 a 100) y search (nombre).
curl -s "$RECLEE_API/job-posts/$JOB_POST_ID/applications?status=QUALIFIED&stageId=a1c3e5f7-1b2d-4e6f-8a9b-0c1d2e3f4a51&page=1&pageSize=50" \
-H "Authorization: Bearer $RECLEE_API_KEY"{
"rows": [
{
"applicationId": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74",
"profileId": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52",
"name": "Martina Ocampo",
"stageId": "a1c3e5f7-1b2d-4e6f-8a9b-0c1d2e3f4a51",
"status": "QUALIFIED",
"origin": "MANUAL",
"appliedAt": "2026-10-22T14:20:00.000Z",
"score": null,
"labels": []
}
],
"total": 2,
"page": 1,
"pageSize": 50,
"unmatchedLabels": []
}unmatchedLabels lista los nombres del filtro labels que no existen en tu workspace; si hay alguno, la página viene vacía. Un parámetro que la ruta no conoce contesta 400 INVALID. Ver Paginación.
Mueve un candidato de etapa
move_application_stage mueve una postulación QUALIFIED a otra etapa de la misma vacante:
curl -s -X POST "$RECLEE_API/actions/move_application_stage" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"applicationId": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74",
"stageId": "b2d4f6a8-2c3e-4f7a-9b0c-1d2e3f4a5b62"
}'{
"data": { "stage": "SCREENING" },
"links": [ { "kind": "application", "id": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "label": "Martina Ocampo", "href": "https://app.reclee.com/..." } ]
}Algunas etapas tienen condiciones. Las negativas que vas a ver:
| Código | Status | Qué pasa |
|---|---|---|
INVALID | 400 | El candidato no está QUALIFIED, ya está en esa etapa, o mandaste hire a una etapa que no es la última. |
SCREENING_PENDING | 409 | Hay una respuesta de screening eliminatoria esperando revisión. |
REPORT_REQUIRED | 409 | Para llegar a la shortlist el candidato necesita un informe. |
SHORTLIST_FIRST | 409 | Solo se contrata desde la etapa anterior a la última. |
HIRE_TERMS_REQUIRED | 400 | La última etapa contrata: manda hire con salary y startDate. Ver CRM: del lead al placement. |
DO_NOT_CONTACT | 409 | La persona está marcada como No contactar. |
Mueve varios a la vez
move_applications_stage mueve hasta 200 postulaciones de una vacante a la misma etapa. Cada candidato se decide por separado: los que no pasan una condición vuelven en refused y el resto se mueve igual. Quien ya está en esa etapa, ya no está QUALIFIED o está marcado «No contactar» no se mueve; si nadie de la selección se puede mover, la acción contesta esa negativa en lugar de escribir.
curl -s -X POST "$RECLEE_API/actions/move_applications_stage" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
"applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"],
"stageId": "c3e5a7b9-3d4f-4a8b-8c1d-2e3f4a5b6c73"
}'{
"data": {
"moved": 1,
"refused": [{ "applicationId": "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85", "error": "SCREENING_PENDING" }]
},
"links": [ … ]
}La última etapa (contratación) no se ofrece en lote: contesta 400 INVALID. Cada contratación va por move_application_stage con hire.
Etiqueta a los candidatos
Los labels marcan en qué punto está cada candidato dentro de la vacante («Esperando respuesta», «Pidió más sueldo»). Las acciones solo usan labels que ya existen en el workspace: léelos con GET /ats/labels (por MCP, con la tool list_labels).
curl -s "$RECLEE_API/ats/labels" -H "Authorization: Bearer $RECLEE_API_KEY"{
"rows": [ { "id": "0e2a4c6d-1f3b-4c5d-8e7a-9b1c3d5e7f96", "name": "Esperando respuesta", "color": "amber", "systemKey": null, "applicationCount": 4 } ],
"total": 1,
"page": 1,
"pageSize": 50
}Para uno, add_application_label (y remove_application_label para sacarlo). Para varios, set_applications_labels, que pone y saca en una sola llamada:
curl -s -X POST "$RECLEE_API/actions/set_applications_labels" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
"applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"],
"add": ["Esperando respuesta"]
}'{
"data": { "labeled": 2, "labels": ["Esperando respuesta"], "refused": [] },
"links": [ … ]
}Un nombre que no existe contesta 404 LABEL_NOT_FOUND. Las acciones no crean labels; si necesitas uno nuevo, créalo con POST /ats/labels ({ "name": "…" }). Un label no se borra: se archiva con update_label.
Comenta
add_application_comment deja una nota para el equipo, con sentiment opcional (GOOD, NEUTRAL, BAD). Sin stageId, el comentario queda en la etapa actual del candidato.
curl -s -X POST "$RECLEE_API/actions/add_application_comment" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"applicationId": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74",
"body": "Muy buena llamada inicial, tiene disponibilidad en noviembre.",
"sentiment": "GOOD"
}'{ "data": { "commentId": "1f3b5d7e-2a4c-4d6e-9f8b-0c2d4e6f8a07" }, "links": [ … ] }Los comentarios de una postulación se leen con GET /ats/applications/{applicationId}/comments (paginado). Para responder, reply_to_comment con el commentId de un comentario raíz; una respuesta no se puede responder.
Descalifica o restaura
disqualify_application saca a un candidato del pipeline con un motivo: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE u OTHER. La etapa no cambia: el embudo conserva hasta dónde llegó.
curl -s -X POST "$RECLEE_API/actions/disqualify_application" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"applicationId": "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85",
"reason": "COMPENSATION_MISMATCH",
"comment": "Pide 30% más que el rango del cliente."
}'{ "data": { "status": "DISQUALIFIED", "reason": "COMPENSATION_MISMATCH" }, "links": [ … ] }Para deshacerlo, restore_application con un comment: el cliente lo lee en el informe como excepción al screening, así que tiene que ser el motivo que dio la persona. Quien cortó puede devolver sin comentario poco después del corte; si no, la acción contesta 400 COMMENT_REQUIRED. Un candidato que no está descalificado contesta 400 INVALID.
curl -s -X POST "$RECLEE_API/actions/restore_application" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"applicationId": "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85",
"comment": "El cliente amplió el rango salarial."
}'Para muchos a la vez, set_applications_status: DISQUALIFIED necesita reason, y volver a QUALIFIED a alguien descalificado puede necesitar comment (si falta, ese candidato vuelve en refused con COMMENT_REQUIRED). Los rechazados vuelven en refused (por ejemplo HIRED_IS_FINAL para alguien ya contratado).
Calcula el match score
run_match_score mide a los candidatos contra los criterios de sourcing de la vacante (ver Hacer sourcing de candidatos). Con applicationIds mide exactamente esos; sin ellos, a todos los QUALIFIED cuyo score falta o quedó viejo.
Consume uso de IA
Cada cálculo consume uso de IA del mes. La respuesta trae cost con lo que gastó esa llamada. Ver Créditos y uso.
curl -s -X POST "$RECLEE_API/actions/run_match_score" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 2a4c6e8f-3b5d-4e7f-8a9c-1d3e5f7a9b18" \
-d '{
"jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
"applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74"]
}'{
"data": { "scored": 1, "skipped": 0, "failed": 0, "remaining": 0, "unscorable": [] },
"links": [ … ],
"next": { "missing": [], "suggestions": [] },
"cost": { "aiUsagePct": 0.002, "teamUsagePct": 0, "credits": 0, "billedLater": false }
}Si alguien no tiene datos para medirse, vuelve en unscorable y next sugiere enrich_profile con sus profileIds. El score queda en cada fila de GET /job-posts/{jobPostId}/applications (score.scorePct de 0 a 100, con coveragePct), y puedes filtrar con minScore.
| Código | Status | Qué pasa |
|---|---|---|
NO_SOURCING_CRITERIA | 409 | La vacante no tiene criterios de sourcing. |
NOTHING_TO_SCORE | 409 | No hay nadie para medir en el alcance pedido. |
NOT_RESCORABLE | 409 | Algún applicationId no es de esta vacante. |
USAGE_EXHAUSTED | 402 | Se agotó el uso del mes; lo que no se midió queda en remaining. |