Reclee

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.

  • linkedinUrls acepta 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 en notInPool. Para traerlas, usa enrich_profile y después agrégalas. Si ninguna de las personas está en el pool, responde NOT_FOUND y sugiere enrich_profile.
  • Un borrador no recibe candidatos: responde JOB_POST_DRAFT con 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.
POST/actions/add_to_job_post

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
profileIdsstring[] (uuid)OpcionalPersonas del talent pool (GET /talent/pool). Hasta 200 elementos.
linkedinUrlsstring[]OpcionalURLs 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ódigoHTTPCuándo
NOT_FOUND404Ninguna de las personas está en el pool (suggestions trae enrich_profile), o la vacante no existe.
JOB_POST_DRAFT409La vacante es un borrador. missing dice qué le falta para publicarse.
INVALID400Ninguna 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 con generate_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.

  • hire en cualquier otra etapa responde INVALID.
  • Si la contratación ya está registrada (porque el movimiento anterior no llegó a completarse), mover a la última etapa sin hire es un movimiento normal y la termina. Enviar hire otra vez responde ALREADY_HIRED.
POST/actions/move_application_stage

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
stageIdstring (uuid)SíEtapa de destino, de la misma vacante.
hireobjectOpcionalCondiciones de la contratación. Solo para mover a la última etapa.
hire.salarynumberSíSalario acordado. Mayor que 0.
hire.startDatestring (date)SíFecha de inicio. Formato YYYY-MM-DD.
hire.currencyCodeenumOpcionalMoneda del salario (ISO 4217). Omitida: la de la vacante.
hire.salaryPeriodenumOpcionalPeríodo del salario. Omitido: el de la vacante. Valores: HOURLY, DAILY, MONTHLY, YEARLY.
hire.feePctnumberOpcionalPorcentaje de fee. Omitido: el del cliente. Entre 0 y 100.
hire.guaranteeDaysintegerOpcionalDí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ódigoHTTPCuándo
INVALID400El candidato no está QUALIFIED, ya está en esa etapa, o se envió hire para una etapa que no es la última.
NOT_FOUND404La etapa no es de esta vacante, o la postulación no existe.
HIRE_TERMS_REQUIRED400Mover a la última etapa sin hire. missing: salary, startDate.
PAY_TERMS_REQUIRED400Ni la llamada ni la vacante dicen la moneda y el período del salario.
ALREADY_HIRED409Se envió hire y la contratación ya estaba registrada.
SHORTLIST_FIRST409Contratar a alguien que no está en shortlist.
PLACEMENT_REQUIRED409Mover a la última etapa sin contratación registrada.
JOB_POST_DRAFT409La vacante es un borrador: nadie se mueve en un borrador. missing dice qué le falta para publicarse.
SCREENING_PENDING409Pasar de Screening con una respuesta knockout que todavía espera revisión (ver review_screening_answer).
SCREENING_FAILED409Pasar de Screening con una respuesta knockout confirmada como no superada.
REPORT_REQUIRED409Mover a shortlist (la anteúltima etapa) sin un reporte construido. suggestions trae generate_report.
DO_NOT_CONTACT409La persona está marcada «no contactar» en el workspace.
HIRED_IS_FINAL409El candidato ya está en la etapa de contratación: una contratación es definitiva.
STALE409Alguien 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).

POST/actions/move_applications_stage

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
applicationIdsstring[] (uuid)SíIds de postulaciones de esta vacante (GET /job-posts/{jobPostId}/applications). De 1 a 200 elementos.
stageIdstring (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ódigoHTTPCuándo
INVALID400La etapa de destino es la última (contratación).
NOT_FOUND404La etapa no es de esta vacante, o la vacante no existe.
JOB_POST_DRAFT409La vacante es un borrador. missing dice qué le falta.
DO_NOT_CONTACT, STALE, NOTHING_TO_CHANGE409Nadie 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.

POST/actions/disqualify_application

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
reasonenumSí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.
commentstringOpcionalComentario 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ódigoHTTPCuándo
INVALID400El candidato ya está cortado.
COMMENT_REQUIRED400El motivo exige un comentario (por ejemplo, OTHER).
HIRED_IS_FINAL409El candidato ya fue contratado.
NOT_FOUND404La 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.

POST/actions/restore_application

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
commentstringOpcionalPor 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ódigoHTTPCuándo
INVALID400El candidato no está cortado.
COMMENT_REQUIRED400Falta comment: solo quien cortó puede devolver sin comentario, y solo poco después del corte.
NOT_FOUND404La 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".

POST/actions/withdraw_application

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
commentstringOpcionalComentario 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ódigoHTTPCuándo
INVALID400El candidato no está QUALIFIED.
NOT_FOUND404La 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.

  • DISQUALIFIED los corta y exige reason (y OTHER exige también comment). reason solo va con DISQUALIFIED.
  • WITHDRAWN registra que se bajaron.
  • QUALIFIED los devuelve. Devolver a alguien cortado puede exigir comment, 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 en refused con COMMENT_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.

POST/actions/set_applications_status

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
applicationIdsstring[] (uuid)SíIds de postulaciones de esta vacante (GET /job-posts/{jobPostId}/applications). De 1 a 200 elementos.
statusenumSíEstado nuevo. Valores: DISQUALIFIED, WITHDRAWN, QUALIFIED.
reasonenumOpcionalMotivo 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.
commentstringOpcionalComentario. 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ódigoHTTPCuándo
INVALID400reason sin DISQUALIFIED, o DISQUALIFIED sin reason (error de validación del body).
NOT_FOUND404La 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.

POST/actions/add_application_label

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
namestringSí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ódigoHTTPCuándo
LABEL_NOT_FOUND404El workspace no tiene una etiqueta con ese nombre.
NOT_FOUND404La 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.

POST/actions/remove_application_label

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
namestringSí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ódigoHTTPCuándo
NOT_FOUND404La 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.

POST/actions/set_applications_labels

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
applicationIdsstring[] (uuid)SíIds de postulaciones de esta vacante (GET /job-posts/{jobPostId}/applications). De 1 a 200 elementos.
addstring[]OpcionalEtiquetas a poner. Hasta 20 elementos. Cada uno de hasta 60 caracteres. Por defecto: [].
removestring[]OpcionalEtiquetas 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ódigoHTTPCuándo
LABEL_NOT_FOUND404Algún nombre no es una etiqueta del workspace.
INVALID400add y remove vacíos.
NOT_FOUND404La 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.

  • name la renombra en todas las postulaciones que la tienen. Un nombre que ya usa otra etiqueta responde NAME_TAKEN.
  • archived: true la 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.

POST/actions/update_label

Body

CampoTipoRequeridoDescripción
labelIdstring (uuid)SíId de la etiqueta (GET /ats/labels).
namestringOpcionalNombre nuevo. Excluyente con archived. Hasta 60 caracteres.
archivedtrueOpcionaltrue 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ódigoHTTPCuándo
NAME_TAKEN409Otra etiqueta ya tiene ese nombre.
SYSTEM_LABEL409Es la etiqueta de sistema.
INVALID400Se enviaron name y archived a la vez, o ninguno.
NOT_FOUND404La 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.

POST/actions/add_application_comment

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
bodystringSíTexto del comentario. Hasta 5.000 caracteres.
sentimentenumOpcionalValoración del comentario. Valores: GOOD, NEUTRAL, BAD.
stageIdstring (uuid)OpcionalEtapa 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ódigoHTTPCuándo
NOT_FOUND404La 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.

POST/actions/update_application_comment

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
commentIdstring (uuid)SíId del comentario a corregir.
bodystringSíTexto completo nuevo. Hasta 5.000 caracteres.
sentimentenum | nullOpcionalValoración nueva (solo comentarios raíz). null la quita; omitida, no cambia. Valores: GOOD, NEUTRAL, BAD.
stageIdstring (uuid)OpcionalEtapa 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ódigoHTTPCuándo
NOT_FOUND404El comentario no es de esta postulación, lo escribió otra persona, o stageId no es de la vacante.
INVALID400Se 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).

POST/actions/reply_to_comment

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
commentIdstring (uuid)SíId del comentario raíz a responder.
bodystringSí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ódigoHTTPCuándo
INVALID400commentId es una respuesta, no un comentario raíz.
NOT_FOUND404El 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_GUARANTEE y 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.
POST/actions/activate_guarantee

Body

CampoTipoRequeridoDescripción
leftAtstring (date)SíDía en que dejó al cliente. Formato YYYY-MM-DD.
reasonenumSíMotivo de la salida: RESIGNED (renunció), DISMISSED (lo despidieron), OTHER. Valores: RESIGNED, DISMISSED, OTHER.
notestring | nullOpcionalNota opcional sobre la salida. Hasta 2.000 caracteres.
applicationIdstring (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ódigoHTTPCuándo
OUTSIDE_GUARANTEE409La salida es posterior al fin de la garantía, o la contratación no tiene garantía.
GUARANTEE_ALREADY_USED409Ya se registró una salida para esta contratación.
NOT_HIRED409El candidato no fue contratado.
EXIT_BEFORE_START400leftAt es anterior a la fecha de inicio.
NOT_FOUND404La 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 (true o false) 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 con overrideReason, que es obligatorio: la respuesta queda registrada y el knockout deja de contar. Un CONFIRMED posterior lo revierte.
  • passed solo va con CONFIRMED y en respuestas de texto (si no, INVALID).
POST/actions/review_screening_answer

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
answerIdstring (uuid)SíId de la respuesta de screening.
reviewenumSíCómo se resuelve. Valores: CONFIRMED, DISMISSED.
overrideReasonstringOpcionalPor qué se deja de contar. Obligatorio con DISMISSED. Hasta 1.000 caracteres.
passedbooleanOpcionalCorrige 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ódigoHTTPCuándo
INVALID400DISMISSED sin overrideReason, o passed fuera de CONFIRMED o en una respuesta que no es de texto.
NOT_FOUND404La 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 responde NOT_RESCORABLE antes de calcular nada.
  • Sin applicationIds, el alcance: qualifiedOnly (por defecto true; false toma todos los estados salvo retirados), stageIds (por defecto todas las etapas) y pendingOnly para los que nunca se calcularon.
  • Sin ninguno de los tres, todos los QUALIFIED cuyo 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).

POST/actions/run_match_score

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
applicationIdsstring[] (uuid)OpcionalPostulaciones exactas a calcular. Si se envían, se ignora el alcance. Hasta 200 elementos.
profileenumOpcionalQué lee el cálculo: DEFAULT (el CV si hay), OWN (el CV), PUBLIC (LinkedIn). Valores: DEFAULT, OWN, PUBLIC.
qualifiedOnlybooleanOpcionalSolo candidatos QUALIFIED. Por defecto true; false toma todos salvo los retirados.
stageIdsstring[] (uuid)OpcionalEtapas a incluir. Por defecto, todas. Hasta 50 elementos.
pendingOnlybooleanOpcionalSolo los que nunca se calcularon.
causeenumOpcionalPor 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ódigoHTTPCuándo
NO_SOURCING_CRITERIA409La vacante no tiene criterios de sourcing. suggestions trae write_sourcing_criteria.
NOTHING_TO_SCORE409El alcance pedido no tiene a nadie para calcular.
NOT_RESCORABLE409Algún applicationIds no es de esta vacante.
USAGE_EXHAUSTED402Se agotó el uso de IA del mes antes de calcular a alguien.
USAGE_WINDOW402Se alcanzó el límite de la ventana de cinco horas antes de calcular a alguien.
SEAT_REQUIRED403La persona dueña de la key no tiene asiento.

Los scores se leen con GET /job-posts/{jobPostId}/match-scores.

En esta página