Postulaciones
Acciones sobre los candidatos de una vacante: sumarlos al pipeline, moverlos de etapa, cambiar su estado, etiquetas, comentarios, garantía, screening y match score.
Una postulación (application) es una persona del talent pool dentro del pipeline de una vacante. Estas acciones la crean, la mueven y la anotan. Para leer el pipeline usa GET /job-posts/{jobPostId}/applications; para una postulación con sus etapas, GET /ats/applications/{applicationId}/context. Cómo se llama a una acción y los errores comunes están en Acciones.
Una postulación tiene un estado (QUALIFIED, DISQUALIFIED, WITHDRAWN) y está parada en una etapa del embudo. Son independientes: cortar a alguien no cambia su etapa, y solo un candidato QUALIFIED se mueve de etapa.
add_to_job_post
Familia: DO · No consume créditos ni uso del plan.
Suma una o más personas del talent pool al pipeline de una vacante, igual que un alta manual: entran QUALIFIED, en la primera etapa y sin match score. Hasta 200 por llamada entre profileIds y linkedinUrls, y al menos una.
linkedinUrlsacepta URLs de LinkedIn (o el handle solo) de personas que ya están en el pool; cada una se busca tal como la enviaste. Esta acción nunca le paga al proveedor: una URL que nadie del pool tiene no se agrega y vuelve ennotInPool. Para traerlas, usaenrich_profiley después agrégalas. Si ninguna de las personas está en el pool, respondeNOT_FOUNDy sugiereenrich_profile.- Un borrador no recibe candidatos: responde
JOB_POST_DRAFTcon lo que le falta para publicarse. - Quien ya estaba en el pipeline, o un perfil que el workspace no puede ver, se saltea y se cuenta, sin error. Quien está marcado «no contactar» nunca se agrega y vuelve contado en
blocked.
/actions/add_to_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| profileIds | string[] (uuid) | Opcional | Personas del talent pool (GET /talent/pool). Hasta 200 elementos. |
| linkedinUrls | string[] | Opcional | URLs o handles de LinkedIn de personas que ya están en el pool. Entre profileIds y linkedinUrls, de 1 a 200 en total. Hasta 200 elementos. Cada uno de hasta 300 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/add_to_job_post \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"profileIds": [
"9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d",
"0a1b2c3d-4e5f-4a6b-9c7d-8e9f0a1b2c3d"
],
"linkedinUrls": [
"https://www.linkedin.com/in/martin-rios-dev"
]
}'Respuesta
200 OK
{
"data": {
"added": 2,
"already": 0,
"unknown": 0,
"blocked": 0,
"applicationIds": [
"5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"8f9a0b1c-2d3e-4f4a-8b5c-6d7e8f9a0b1c"
],
"linkedin": [
{
"linkedinUrl": "https://www.linkedin.com/in/martin-rios-dev",
"profileId": null
}
],
"notInPool": [
"https://www.linkedin.com/in/martin-rios-dev"
]
},
"links": [
{
"kind": "job_post",
"id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"label": "Senior Backend Engineer",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
}
],
"next": {
"missing": [],
"suggestions": [
{
"tool": "enrich_profile",
"input": {
"linkedinUrls": [
"https://www.linkedin.com/in/martin-rios-dev"
]
}
},
{
"tool": "run_match_score",
"input": {
"jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"applicationIds": [
"5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"8f9a0b1c-2d3e-4f4a-8b5c-6d7e8f9a0b1c"
]
}
},
{
"tool": "list_applications",
"input": {
"jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
}
}
]
}
}added, already, unknown y blocked cuentan qué pasó con cada persona. applicationIds son las postulaciones recién creadas, listas para run_match_score. linkedin y notInPool solo aparecen si enviaste linkedinUrls.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | Ninguna de las personas está en el pool (suggestions trae enrich_profile), o la vacante no existe. |
JOB_POST_DRAFT | 409 | La vacante es un borrador. missing dice qué le falta para publicarse. |
INVALID | 400 | Ninguna persona, o más de 200 entre los dos campos. |
Para moverlos de etapa: move_application_stage o move_applications_stage.
move_application_stage
Familia: DO · No consume créditos ni uso del plan.
Mueve a un candidato a otra etapa del pipeline de su vacante. Solo se mueve un candidato QUALIFIED, y nadie se mueve en un borrador. El servidor aplica las compuertas del pipeline en cada movimiento:
- Pasar de Screening exige que ninguna respuesta knockout esté pendiente (
SCREENING_PENDING) ni confirmada como no superada (SCREENING_FAILED). - Entrar a shortlist (la anteúltima etapa) exige un reporte construido (
REPORT_REQUIRED; se construye congenerate_report). - La última etapa contrata: solo se llega desde shortlist (
SHORTLIST_FIRST) y exige una contratación registrada.
Contratar. Para mover a la última etapa envía hire con el salario acordado y la fecha de inicio; sin hire responde HIRE_TERMS_REQUIRED. La moneda, el período del salario y el porcentaje de fee se heredan de la vacante y de su cliente cuando los omites, así que envíalos solo si son otros; si ni la llamada ni la vacante dicen moneda y período, responde PAY_TERMS_REQUIRED. hire.guaranteeDays reemplaza la garantía del cliente (90 días si el cliente no tiene una). Si la vacante tiene una garantía activada, esta contratación es el reemplazo y no factura fee.
hireen cualquier otra etapa respondeINVALID.- Si la contratación ya está registrada (porque el movimiento anterior no llegó a completarse), mover a la última etapa sin
hirees un movimiento normal y la termina. Enviarhireotra vez respondeALREADY_HIRED.
/actions/move_application_stageBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| stageId | string (uuid) | Sí | Etapa de destino, de la misma vacante. |
| hire | object | Opcional | Condiciones de la contratación. Solo para mover a la última etapa. |
| hire.salary | number | Sí | Salario acordado. Mayor que 0. |
| hire.startDate | string (date) | Sí | Fecha de inicio. Formato YYYY-MM-DD. |
| hire.currencyCode | enum | Opcional | Moneda del salario (ISO 4217). Omitida: la de la vacante. |
| hire.salaryPeriod | enum | Opcional | Período del salario. Omitido: el de la vacante. Valores: HOURLY, DAILY, MONTHLY, YEARLY. |
| hire.feePct | number | Opcional | Porcentaje de fee. Omitido: el del cliente. Entre 0 y 100. |
| hire.guaranteeDays | integer | Opcional | Días de garantía. Omitido: los del cliente, o 90. Entre 1 y 365. |
Un movimiento común solo lleva la postulación y la etapa: {"applicationId": "…", "stageId": "…"}.
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/move_application_stage \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"stageId": "e6f7a8b9-0c1d-4e2f-b03b-4c5d6e7f8a9b",
"hire": {
"salary": 62000,
"startDate": "2026-11-16",
"currencyCode": "USD",
"salaryPeriod": "YEARLY"
}
}'Respuesta
200 OK
{
"data": {
"stage": "HIRED"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}stage es la etapa de destino: su nombre, o su clave de plantilla (SOURCED, SCREENING, INTERVIEW, SHORTLIST, HIRED) si nadie la renombró. Una contratación no devuelve el placement ni el fee: se leen en GET /crm/requests/{requestId}/placements.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | El candidato no está QUALIFIED, ya está en esa etapa, o se envió hire para una etapa que no es la última. |
NOT_FOUND | 404 | La etapa no es de esta vacante, o la postulación no existe. |
HIRE_TERMS_REQUIRED | 400 | Mover a la última etapa sin hire. missing: salary, startDate. |
PAY_TERMS_REQUIRED | 400 | Ni la llamada ni la vacante dicen la moneda y el período del salario. |
ALREADY_HIRED | 409 | Se envió hire y la contratación ya estaba registrada. |
SHORTLIST_FIRST | 409 | Contratar a alguien que no está en shortlist. |
PLACEMENT_REQUIRED | 409 | Mover a la última etapa sin contratación registrada. |
JOB_POST_DRAFT | 409 | La vacante es un borrador: nadie se mueve en un borrador. missing dice qué le falta para publicarse. |
SCREENING_PENDING | 409 | Pasar de Screening con una respuesta knockout que todavía espera revisión (ver review_screening_answer). |
SCREENING_FAILED | 409 | Pasar de Screening con una respuesta knockout confirmada como no superada. |
REPORT_REQUIRED | 409 | Mover a shortlist (la anteúltima etapa) sin un reporte construido. suggestions trae generate_report. |
DO_NOT_CONTACT | 409 | La persona está marcada «no contactar» en el workspace. |
HIRED_IS_FINAL | 409 | El candidato ya está en la etapa de contratación: una contratación es definitiva. |
STALE | 409 | Alguien movió o cortó al candidato entre tu lectura y la escritura. Vuelve a leer y reintenta. |
Las etapas, con sus ids, salen de GET /ats/applications/{applicationId}/context. Para mover a varios a la vez: move_applications_stage.
move_applications_stage
Familia: DO · No consume créditos ni uso del plan.
Mueve varios candidatos de una misma vacante a la misma etapa en una sola llamada (hasta 200). Las compuertas se aplican candidato por candidato: el que no pasa vuelve en refused con su código (REPORT_REQUIRED, SCREENING_PENDING, STALE…) y el resto se mueve igual. Un candidato de otra vacante, uno que no está QUALIFIED, uno que ya está en esa etapa o una persona marcada «No contactar» no se mueve: se cuentan aparte antes de mover, y si nadie de la selección se puede mover, la acción contesta con esa negativa (NOT_FOUND, STALE, NOTHING_TO_CHANGE o DO_NOT_CONTACT) en lugar de escribir.
La última etapa (contratación) no se ofrece acá (INVALID): contratar es por persona, con move_application_stage y hire. Un borrador no mueve a nadie (JOB_POST_DRAFT).
/actions/move_applications_stageBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| applicationIds | string[] (uuid) | Sí | Ids de postulaciones de esta vacante (GET /job-posts/{jobPostId}/applications). De 1 a 200 elementos. |
| stageId | string (uuid) | Sí | Etapa de destino. No puede ser la última. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/move_applications_stage \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"applicationIds": [
"5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"8f9a0b1c-2d3e-4f4a-8b5c-6d7e8f9a0b1c",
"3c4d5e6f-7a8b-4c9d-ae0f-1a2b3c4d5e6f"
],
"stageId": "c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f"
}'Respuesta
200 OK
{
"data": {
"moved": 2,
"refused": [
{
"applicationId": "3c4d5e6f-7a8b-4c9d-ae0f-1a2b3c4d5e6f",
"error": "SCREENING_PENDING"
}
]
},
"links": [
{
"kind": "job_post",
"id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"label": "Senior Backend Engineer",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
}
]
}moved cuenta los que se movieron; refused lista cada uno que no, con su código.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | La etapa de destino es la última (contratación). |
NOT_FOUND | 404 | La etapa no es de esta vacante, o la vacante no existe. |
JOB_POST_DRAFT | 409 | La vacante es un borrador. missing dice qué le falta. |
DO_NOT_CONTACT, STALE, NOTHING_TO_CHANGE | 409 | Nadie de la selección se puede mover: están marcados «No contactar», ya no están QUALIFIED o ya están en esa etapa. |
disqualify_application
Familia: DO · No consume créditos ni uso del plan.
Corta a un candidato del pipeline de una vacante, con su motivo. La etapa no cambia: hasta dónde llegó sigue contando en el reporte del embudo. Un candidato ya cortado responde INVALID.
Si alguien se bajó por su cuenta, usa withdraw_application: un retiro no es un rechazo y queda fuera de las métricas.
/actions/disqualify_applicationBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| reason | enum | Sí | Motivo del corte: NOT_RESPONSIVE (no responde), WITHDREW (se bajó), LOW_EVALUATION_SCORE (evaluación baja), COMPENSATION_MISMATCH (salario), AVAILABILITY_MISMATCH (disponibilidad), CLIENT_REJECTED (lo rechazó el cliente), HIRED_ELSEWHERE (lo contrataron en otro lado), OTHER. Valores: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, OTHER. |
| comment | string | Opcional | Comentario sobre el corte. Hasta 2.000 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/disqualify_application \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"reason": "COMPENSATION_MISMATCH",
"comment": "Pide 30% por encima del rango del cliente."
}'Respuesta
200 OK
{
"data": {
"status": "DISQUALIFIED",
"reason": "COMPENSATION_MISMATCH"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | El candidato ya está cortado. |
COMMENT_REQUIRED | 400 | El motivo exige un comentario (por ejemplo, OTHER). |
HIRED_IS_FINAL | 409 | El candidato ya fue contratado. |
NOT_FOUND | 404 | La postulación no existe en el workspace. |
Para revertirlo: restore_application. Para cortar a varios a la vez: set_applications_status.
restore_application
Familia: DO · No consume créditos ni uso del plan.
Revierte un corte, y solo eso: devuelve al candidato al pipeline en la etapa donde lo cortaron. Un candidato que no está DISQUALIFIED responde INVALID; a quien se retiró se lo devuelve con set_applications_status y status: "QUALIFIED".
El comment es opcional y queda en el reporte del cliente como excepción de screening, así que tiene que ser el motivo que dio la persona, con sus palabras. Quien cortó al candidato puede devolverlo sin comentario poco después del corte; en cualquier otro caso, sin comment la acción contesta COMMENT_REQUIRED antes de escribir nada.
/actions/restore_applicationBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| comment | string | Opcional | Por qué se revierte el corte, en palabras de la persona. Lo lee el cliente en el reporte. De 1 a 2.000 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/restore_application \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"comment": "El cliente aceptó ampliar el rango salarial."
}'Respuesta
200 OK
{
"data": {
"status": "QUALIFIED"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | El candidato no está cortado. |
COMMENT_REQUIRED | 400 | Falta comment: solo quien cortó puede devolver sin comentario, y solo poco después del corte. |
NOT_FOUND | 404 | La postulación no existe en el workspace. |
withdraw_application
Familia: DO · No consume créditos ni uso del plan.
Registra que el candidato se bajó del proceso por su cuenta. A diferencia de un corte, no es un rechazo: queda fuera de todas las métricas del embudo. Solo aplica a un candidato QUALIFIED (si no, INVALID).
Deshacer un retiro se hace desde la app, o con set_applications_status y status: "QUALIFIED".
/actions/withdraw_applicationBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| comment | string | Opcional | Comentario sobre el retiro. Hasta 2.000 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/withdraw_application \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"comment": "Aceptó una contraoferta de su empleador actual."
}'Respuesta
200 OK
{
"data": {
"status": "WITHDRAWN"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | El candidato no está QUALIFIED. |
NOT_FOUND | 404 | La postulación no existe en el workspace. |
set_applications_status
Familia: DO · No consume créditos ni uso del plan.
Cambia el estado de varios candidatos de una misma vacante en una sola llamada (hasta 200). Las etapas no cambian.
DISQUALIFIEDlos corta y exigereason(yOTHERexige tambiéncomment).reasonsolo va conDISQUALIFIED.WITHDRAWNregistra que se bajaron.QUALIFIEDlos devuelve. Devolver a alguien cortado puede exigircomment, que el cliente lee como excepción de screening: tiene que ser el motivo que dio la persona. Quien cortó puede devolver sin comentario poco después del corte; si no, ese candidato vuelve enrefusedconCOMMENT_REQUIRED.
Cada candidato se decide por separado: el que no puede cambiar vuelve en refused con su código (HIRED_IS_FINAL, COMMENT_REQUIRED, INVALID si ya estaba en ese estado, NOT_FOUND si no es de esta vacante) y el resto cambia igual.
/actions/set_applications_statusBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| applicationIds | string[] (uuid) | Sí | Ids de postulaciones de esta vacante (GET /job-posts/{jobPostId}/applications). De 1 a 200 elementos. |
| status | enum | Sí | Estado nuevo. Valores: DISQUALIFIED, WITHDRAWN, QUALIFIED. |
| reason | enum | Opcional | Motivo del corte. Obligatorio con DISQUALIFIED y prohibido con los otros estados: NOT_RESPONSIVE (no responde), WITHDREW (se bajó), LOW_EVALUATION_SCORE (evaluación baja), COMPENSATION_MISMATCH (salario), AVAILABILITY_MISMATCH (disponibilidad), CLIENT_REJECTED (lo rechazó el cliente), HIRED_ELSEWHERE (lo contrataron en otro lado), OTHER. Valores: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, OTHER. |
| comment | string | Opcional | Comentario. Obligatorio con el motivo OTHER y al devolver a alguien cortado. Hasta 2.000 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/set_applications_status \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"applicationIds": [
"5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"8f9a0b1c-2d3e-4f4a-8b5c-6d7e8f9a0b1c",
"3c4d5e6f-7a8b-4c9d-ae0f-1a2b3c4d5e6f"
],
"status": "DISQUALIFIED",
"reason": "NOT_RESPONSIVE"
}'Respuesta
200 OK
{
"data": {
"status": "DISQUALIFIED",
"changed": 2,
"refused": [
{
"applicationId": "3c4d5e6f-7a8b-4c9d-ae0f-1a2b3c4d5e6f",
"error": "HIRED_IS_FINAL"
}
]
},
"links": [
{
"kind": "job_post",
"id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"label": "Senior Backend Engineer",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
}
]
}changed cuenta los que cambiaron; refused lista cada uno que no, con su código.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | reason sin DISQUALIFIED, o DISQUALIFIED sin reason (error de validación del body). |
NOT_FOUND | 404 | La vacante no existe en el workspace. |
add_application_label
Familia: DO · No consume créditos ni uso del plan.
Le pone una etiqueta a la postulación de un candidato: dónde está el proceso dentro de esta vacante, como «esperando respuesta». name tiene que ser una de las etiquetas del workspace (las lista GET /ats/labels, o la tool list_labels por MCP); se compara sin distinguir mayúsculas. Esta acción no crea etiquetas: un nombre que no existe responde LABEL_NOT_FOUND.
/actions/add_application_labelBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| name | string | Sí | Nombre de una etiqueta existente del workspace. Sin distinguir mayúsculas. Hasta 60 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/add_application_label \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"name": "esperando respuesta"
}'Respuesta
200 OK
{
"data": {
"label": "Esperando respuesta"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
LABEL_NOT_FOUND | 404 | El workspace no tiene una etiqueta con ese nombre. |
NOT_FOUND | 404 | La postulación no existe en el workspace. |
Para quitarla: remove_application_label. Para varios candidatos a la vez: set_applications_labels.
remove_application_label
Familia: DO · No consume créditos ni uso del plan.
Le quita una etiqueta a la postulación de un candidato. name se compara sin distinguir mayúsculas; una etiqueta que la postulación no tiene responde NOT_FOUND. La etiqueta sigue existiendo en el workspace para las demás postulaciones.
/actions/remove_application_labelBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| name | string | Sí | Nombre de una etiqueta que la postulación tiene. Sin distinguir mayúsculas. Hasta 60 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/remove_application_label \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"name": "Esperando respuesta"
}'Respuesta
200 OK
{
"data": {
"label": "Esperando respuesta"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La postulación no tiene esa etiqueta, o no existe. |
Para ponerla: add_application_label.
set_applications_labels
Familia: DO · No consume créditos ni uso del plan.
Pone y quita etiquetas a varios candidatos de una misma vacante en una sola llamada (hasta 200 candidatos, hasta 20 etiquetas en add y 20 en remove, al menos una entre las dos). Los nombres son etiquetas existentes del workspace (GET /ats/labels o la tool list_labels), sin distinguir mayúsculas; esta acción no crea etiquetas, así que un nombre que no existe responde LABEL_NOT_FOUND.
Una etiqueta que algún candidato ya tiene se deja como está. Un candidato de otra vacante vuelve en refused como NOT_FOUND.
/actions/set_applications_labelsBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| applicationIds | string[] (uuid) | Sí | Ids de postulaciones de esta vacante (GET /job-posts/{jobPostId}/applications). De 1 a 200 elementos. |
| add | string[] | Opcional | Etiquetas a poner. Hasta 20 elementos. Cada uno de hasta 60 caracteres. Por defecto: []. |
| remove | string[] | Opcional | Etiquetas a quitar. Hasta 20 elementos. Cada uno de hasta 60 caracteres. Por defecto: []. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/set_applications_labels \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"applicationIds": [
"5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"8f9a0b1c-2d3e-4f4a-8b5c-6d7e8f9a0b1c"
],
"add": [
"Entrevista agendada"
],
"remove": [
"Esperando respuesta"
]
}'Respuesta
200 OK
{
"data": {
"labeled": 2,
"labels": [
"Entrevista agendada"
],
"refused": []
},
"links": [
{
"kind": "job_post",
"id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"label": "Senior Backend Engineer",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
}
]
}labeled cuenta a cuántos candidatos se les aplicó el cambio; labels son las etiquetas agregadas, con el nombre que tienen en el workspace.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
LABEL_NOT_FOUND | 404 | Algún nombre no es una etiqueta del workspace. |
INVALID | 400 | add y remove vacíos. |
NOT_FOUND | 404 | La vacante no existe en el workspace. |
update_label
Familia: DO · No consume créditos ni uso del plan.
Renombra o archiva una etiqueta del catálogo del workspace (las etiquetas que llevan las postulaciones en todas las vacantes). Una de las dos cosas por llamada: enviar las dos, o ninguna, responde INVALID.
namela renombra en todas las postulaciones que la tienen. Un nombre que ya usa otra etiqueta respondeNAME_TAKEN.archived: truela archiva: sale del catálogo y de todas las postulaciones a la vez, y el historial conserva su nombre.
Las etiquetas no se borran: archivar es la forma de darlas de baja. La etiqueta de sistema «en campaña» responde SYSTEM_LABEL.
/actions/update_labelBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| labelId | string (uuid) | Sí | Id de la etiqueta (GET /ats/labels). |
| name | string | Opcional | Nombre nuevo. Excluyente con archived. Hasta 60 caracteres. |
| archived | true | Opcional | true la archiva. Excluyente con name. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/update_label \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"labelId": "9f0a1b2c-3d4e-4f5a-ab6c-7d8e9f0a1b2c",
"name": "Pendiente de feedback"
}'Respuesta
200 OK
{
"data": {
"labelId": "9f0a1b2c-3d4e-4f5a-ab6c-7d8e9f0a1b2c",
"name": "Pendiente de feedback",
"archived": false
},
"links": []
}links viene vacío: una etiqueta no tiene pantalla propia.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
NAME_TAKEN | 409 | Otra etiqueta ya tiene ese nombre. |
SYSTEM_LABEL | 409 | Es la etiqueta de sistema. |
INVALID | 400 | Se enviaron name y archived a la vez, o ninguno. |
NOT_FOUND | 404 | La etiqueta no existe en el workspace. |
add_application_comment
Familia: DO · No consume créditos ni uso del plan.
Agrega un comentario raíz (una nota para el equipo, no una respuesta) a la postulación de un candidato. sentiment es opcional: GOOD, NEUTRAL o BAD. Sin stageId, el comentario queda en la etapa donde está el candidato hoy; con stageId opina sobre otra etapa de la misma vacante.
/actions/add_application_commentBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| body | string | Sí | Texto del comentario. Hasta 5.000 caracteres. |
| sentiment | enum | Opcional | Valoración del comentario. Valores: GOOD, NEUTRAL, BAD. |
| stageId | string (uuid) | Opcional | Etapa sobre la que opina. Omitida: la etapa actual del candidato. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/add_application_comment \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"body": "Muy buena entrevista técnica, fuerte en diseño de APIs.",
"sentiment": "GOOD"
}'Respuesta
200 OK
{
"data": {
"commentId": "7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La postulación no existe, o stageId no es una etapa de su vacante. |
Para responderlo: reply_to_comment. Para corregirlo: update_application_comment. Los comentarios se leen con GET /ats/applications/{applicationId}/comments.
update_application_comment
Familia: DO · No consume créditos ni uso del plan.
Corrige un comentario (raíz o respuesta) que escribió la persona dueña de la API key. Los comentarios se corrigen, no se borran. body es el texto completo nuevo y reemplaza al anterior.
En un comentario raíz, sentiment cambia la valoración (null la quita) y stageId lo mueve a otra etapa de la misma vacante, con sus respuestas. Una respuesta no lleva ninguno de los dos. Un comentario de otra persona responde NOT_FOUND.
/actions/update_application_commentBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| commentId | string (uuid) | Sí | Id del comentario a corregir. |
| body | string | Sí | Texto completo nuevo. Hasta 5.000 caracteres. |
| sentiment | enum | null | Opcional | Valoración nueva (solo comentarios raíz). null la quita; omitida, no cambia. Valores: GOOD, NEUTRAL, BAD. |
| stageId | string (uuid) | Opcional | Etapa a la que se mueve (solo comentarios raíz). |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/update_application_comment \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"commentId": "7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a",
"body": "Muy buena entrevista técnica, fuerte en diseño de APIs y en testing.",
"sentiment": null
}'Respuesta
200 OK
{
"data": {
"commentId": "7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a",
"edited": true
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
],
"next": {
"missing": [],
"suggestions": [
{
"tool": "list_application_comments",
"input": {
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60"
}
}
]
}
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | El comentario no es de esta postulación, lo escribió otra persona, o stageId no es de la vacante. |
INVALID | 400 | Se envió sentiment o stageId en una respuesta. |
Los ids de comentario salen de GET /ats/applications/{applicationId}/comments.
reply_to_comment
Familia: DO · No consume créditos ni uso del plan.
Responde a un comentario raíz de la postulación de un candidato. commentId tiene que ser un comentario raíz: una respuesta no se puede responder (INVALID).
/actions/reply_to_commentBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| commentId | string (uuid) | Sí | Id del comentario raíz a responder. |
| body | string | Sí | Texto de la respuesta. Hasta 5.000 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/reply_to_comment \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"commentId": "7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a",
"body": "Coincido. Lo paso a la entrevista con el cliente."
}'Respuesta
200 OK
{
"data": {
"commentId": "8e9f0a1b-2c3d-4e4f-9a5b-6c7d8e9f0a1b"
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | commentId es una respuesta, no un comentario raíz. |
NOT_FOUND | 404 | El comentario no es de esta postulación. |
Los comentarios, con sus ids, salen de GET /ats/applications/{applicationId}/comments.
activate_guarantee
Familia: DO · No consume créditos ni uso del plan.
Registra que un candidato contratado dejó al cliente, dentro de la garantía (leftAt, el motivo y una nota opcional). Si se fue en o antes del último día de la garantía, la activa: una vacante cerrada se reabre y su próxima contratación es un reemplazo que no factura fee. La postulación sigue como contratada.
- Una salida posterior al fin de la garantía, o una contratación sin garantía, responde
OUTSIDE_GUARANTEEy no registra nada: esa salida la registra una persona en la app. - Pasa una vez por contratación: una segunda llamada responde
GUARANTEE_ALREADY_USED. - Alguien que nunca fue contratado responde
NOT_HIRED, y una salida anterior a la fecha de inicio,EXIT_BEFORE_START.
/actions/activate_guaranteeBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leftAt | string (date) | Sí | Día en que dejó al cliente. Formato YYYY-MM-DD. |
| reason | enum | Sí | Motivo de la salida: RESIGNED (renunció), DISMISSED (lo despidieron), OTHER. Valores: RESIGNED, DISMISSED, OTHER. |
| note | string | null | Opcional | Nota opcional sobre la salida. Hasta 2.000 caracteres. |
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/activate_guarantee \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"leftAt": "2027-01-20",
"reason": "RESIGNED",
"note": "Se mudó a otro país."
}'Respuesta
200 OK
{
"data": {
"outcome": "ACTIVATES",
"jobPostReopened": true
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
]
}outcome es ACTIVATES cuando la garantía se activó. jobPostReopened dice si la vacante estaba cerrada y volvió a abrirse.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
OUTSIDE_GUARANTEE | 409 | La salida es posterior al fin de la garantía, o la contratación no tiene garantía. |
GUARANTEE_ALREADY_USED | 409 | Ya se registró una salida para esta contratación. |
NOT_HIRED | 409 | El candidato no fue contratado. |
EXIT_BEFORE_START | 400 | leftAt es anterior a la fecha de inicio. |
NOT_FOUND | 404 | La postulación no existe en el workspace. |
review_screening_answer
Familia: DO · No consume créditos ni uso del plan.
Resuelve una respuesta de screening de un candidato. Las respuestas se revisan, no se borran.
review: "CONFIRMED"la confirma. En una respuesta de texto,passed(trueofalse) corrige lo que interpretó la IA; confirmar como no superada una respuesta knockout de texto corta al candidato, citando su respuesta.review: "DISMISSED"la saca del conteo conoverrideReason, que es obligatorio: la respuesta queda registrada y el knockout deja de contar. UnCONFIRMEDposterior lo revierte.passedsolo va conCONFIRMEDy en respuestas de texto (si no,INVALID).
/actions/review_screening_answerBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| answerId | string (uuid) | Sí | Id de la respuesta de screening. |
| review | enum | Sí | Cómo se resuelve. Valores: CONFIRMED, DISMISSED. |
| overrideReason | string | Opcional | Por qué se deja de contar. Obligatorio con DISMISSED. Hasta 1.000 caracteres. |
| passed | boolean | Opcional | Corrige si la respuesta de texto superó la pregunta. Solo con CONFIRMED. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/review_screening_answer \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"answerId": "0b1c2d3e-4f5a-4b6c-bd7e-8f9a0b1c2d3e",
"review": "CONFIRMED",
"passed": true
}'Respuesta
200 OK
{
"data": {
"answerId": "0b1c2d3e-4f5a-4b6c-bd7e-8f9a0b1c2d3e",
"review": "CONFIRMED",
"passed": true,
"verdict": "PASSED",
"failed": 0,
"waitingForReview": 0
},
"links": [
{
"kind": "application",
"id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
"label": "Lucía Fernández",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
}
],
"next": {
"missing": [],
"suggestions": [
{
"tool": "list_screening_answers",
"input": {
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60"
}
},
{
"tool": "get_application",
"input": {
"applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60"
}
}
]
}
}verdict es el resultado del screening después del cambio: PASSED, FAILED, NEEDS_REVIEW o NOT_SCREENED. failed cuenta los knockouts no superados y waitingForReview los que esperan revisión.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | DISMISSED sin overrideReason, o passed fuera de CONFIRMED o en una respuesta que no es de texto. |
NOT_FOUND | 404 | La respuesta no es de esta postulación. |
Las respuestas, con sus ids, salen de GET /ats/applications/{applicationId}/screening.
run_match_score
Familia: PROVIDER · No consume créditos. Consume uso de IA del plan, informado en cost. Solo para miembros con asiento.
Calcula el Match Score de candidatos del pipeline, en cualquier etapa, contra los criterios de sourcing de la vacante. Cada cálculo es una versión nueva. Fuera de la primera etapa nunca corta a nadie, y alguien que el sistema había cortado y ahora supera el umbral vuelve a QUALIFIED.
A quién calcula:
- Con
applicationIds, exactamente esos; si alguno no es de esta vacante respondeNOT_RESCORABLEantes de calcular nada. - Sin
applicationIds, el alcance:qualifiedOnly(por defectotrue;falsetoma todos los estados salvo retirados),stageIds(por defecto todas las etapas) ypendingOnlypara los que nunca se calcularon. - Sin ninguno de los tres, todos los
QUALIFIEDcuyo score falta o está desactualizado.
profile elige qué lee el cálculo: OWN (el CV del candidato), PUBLIC (su perfil de LinkedIn) o DEFAULT (el CV si tiene).
Si el uso de IA se agota en el camino, lo que no alcanzó queda pendiente y se cuenta en remaining. Si no alcanzó para ninguno, responde USAGE_EXHAUSTED (o el límite que corresponda).
/actions/run_match_scoreBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| applicationIds | string[] (uuid) | Opcional | Postulaciones exactas a calcular. Si se envían, se ignora el alcance. Hasta 200 elementos. |
| profile | enum | Opcional | Qué lee el cálculo: DEFAULT (el CV si hay), OWN (el CV), PUBLIC (LinkedIn). Valores: DEFAULT, OWN, PUBLIC. |
| qualifiedOnly | boolean | Opcional | Solo candidatos QUALIFIED. Por defecto true; false toma todos salvo los retirados. |
| stageIds | string[] (uuid) | Opcional | Etapas a incluir. Por defecto, todas. Hasta 50 elementos. |
| pendingOnly | boolean | Opcional | Solo los que nunca se calcularon. |
| cause | enum | Opcional | Por qué se recalculan los candidatos indicados: REGENERATE (por defecto) o NEW_CV. Solo con applicationIds. Valores: REGENERATE, NEW_CV. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/run_match_score \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: score-backend-2026-10-22" \
-d '{
"jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"pendingOnly": true
}'Respuesta
200 OK
{
"data": {
"scored": 14,
"skipped": 1,
"failed": 0,
"remaining": 0,
"unscorable": [
{
"applicationId": "3c4d5e6f-7a8b-4c9d-ae0f-1a2b3c4d5e6f",
"profileId": "4e5f6a7b-8c9d-4e0f-a1a2-b3c4d5e6f7a8"
}
]
},
"links": [
{
"kind": "job_post",
"id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
"label": "Senior Backend Engineer",
"href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/pipeline"
}
],
"next": {
"missing": [
"profileData"
],
"suggestions": [
{
"tool": "enrich_profile",
"input": {
"profileIds": [
"4e5f6a7b-8c9d-4e0f-a1a2-b3c4d5e6f7a8"
]
}
}
]
},
"cost": {
"aiUsagePct": 0.011,
"teamUsagePct": 0,
"credits": 0,
"billedLater": false
}
}scored, skipped (sin nada para leer), failed y remaining cuentan el resultado. unscorable lista a quienes se saltearon por falta de datos: enrich_profile les da algo para leer, y next lo sugiere con sus profileIds.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
NO_SOURCING_CRITERIA | 409 | La vacante no tiene criterios de sourcing. suggestions trae write_sourcing_criteria. |
NOTHING_TO_SCORE | 409 | El alcance pedido no tiene a nadie para calcular. |
NOT_RESCORABLE | 409 | Algún applicationIds no es de esta vacante. |
USAGE_EXHAUSTED | 402 | Se agotó el uso de IA del mes antes de calcular a alguien. |
USAGE_WINDOW | 402 | Se alcanzó el límite de la ventana de cinco horas antes de calcular a alguien. |
SEAT_REQUIRED | 403 | La persona dueña de la key no tiene asiento. |
Los scores se leen con GET /job-posts/{jobPostId}/match-scores.