Reclee

ATS

Postulaciones, comentarios, etiquetas, compatibilidad, evaluación, informe, screening y entrevistas.

Las rutas /ats trabajan sobre la postulación de un candidato a una vacante: moverla por el embudo, comentarla, evaluarla, armar el informe para el cliente y llevar sus entrevistas. Las postulaciones de una vacante se listan desde Vacantes.

Todas las rutas usan la base https://app.reclee.com/api/v1 y el header Authorization: Bearer rcl_…. Cómo leer esta página (parámetros, paginación, errores y su relación con las acciones) está en el índice de la referencia.

Errores que valen para todas las rutas

UNAUTHENTICATED (401) sin una API key válida; FORBIDDEN (403) cuando tu rol no puede escribir (o la ruta es sólo para OWNER); NOT_FOUND (404) cuando el recurso no existe en tu workspace; INVALID (400) con details cuando el body o la query no pasan la validación; RATE_LIMITED (429) pasado el límite. Cada endpoint lista abajo sólo sus errores propios. Ver Errores.

Rutas que usan IA

Las rutas que redactan con IA (resumen de compatibilidad, borrador del scorecard y del informe, indicaciones, generación de preguntas y respuestas, traducción del informe) consumen uso de IA del plan y pueden tardar varios segundos. Mándalas con Idempotency-Key para reintentar sin pagar dos veces. Ver Idempotencia.

Postulaciones

Una postulación une a una persona con una vacante: tiene etapa, estado (QUALIFIED, DISQUALIFIED, WITHDRAWN) y origen (SOURCED, MANUAL, CAREER_SITE). Las postulaciones de una vacante se listan con GET /job-posts/{jobPostId}/applications (ver Vacantes).

GET /ats/applications/{applicationId}/context

GET/ats/applications/{applicationId}/context

Devuelve lo necesario para trabajar una postulación fuera de su vacante: la vacante, la persona, la etapa y el estado, el embudo de etapas, el equipo de la vacante y los miembros del workspace. Es el apoyo de la ficha del candidato.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/context" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
  "jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
  "jobPostTitle": "Backend Engineer Sr.",
  "profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
  "ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
  "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
  "status": "QUALIFIED",
  "origin": "SOURCED",
  "disqualification": null,
  "stages": [
    {
      "id": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
      "name": null,
      "templateKey": "SOURCED",
      "position": 0,
      "isLocked": true
    },
    {
      "id": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
      "name": "Entrevista técnica",
      "templateKey": "INTERVIEW",
      "position": 2,
      "isLocked": false
    }
  ],
  "members": [
    {
      "id": "0c1e3a5b-7d9f-4c1e-83a5-7d9f1b3c5e7a",
      "jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
      "workspaceMemberId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
      "createdAt": "2026-09-28T10:00:00.000Z"
    }
  ],
  "roster": [
    {
      "id": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
      "userId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
      "firstName": "Lucía",
      "lastName": "Gómez",
      "avatarUrl": null,
      "role": "RECRUITER"
    }
  ],
  "sourcingCriteriaCount": 6,
  "coverLetter": null
}

ownerId y members[].workspaceMemberId son ids de membresía; roster[].userId es el id de usuario que piden los campos de entrevistador o evaluador. Una etapa con name: null sigue con el nombre de plantilla: léela por templateKey.

Errores

  • NOT_FOUND (404): la postulación no existe en tu workspace.

GET /ats/applications/{applicationId}/cover-letter

GET/ats/applications/{applicationId}/cover-letter

Devuelve la carta de presentación que la persona escribió en el formulario del sitio de empleo, como texto, o null si no escribió nada.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/cover-letter" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

"Hola, me interesa el puesto porque llevo siete años trabajando con Go…"

Errores

  • NOT_FOUND (404)

GET /ats/applications/{applicationId}/timeline

GET/ats/applications/{applicationId}/timeline

Devuelve la historia completa de la postulación, de lo más viejo a lo más nuevo: comentarios y eventos (cambios de etapa, de estado, etiquetas, match score, entrevistas, informe…). Viene dos veces: agrupada por etapa en groups y plana en entries.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/timeline" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "groups": [
    {
      "stageId": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
      "stageName": null,
      "enteredAt": "2026-10-02T14:21:07.000Z",
      "entries": [
        {
          "kind": "APPLICATION_CREATED",
          "occurredAt": "2026-10-02T14:21:07.000Z",
          "actorId": null,
          "actorKind": "SYSTEM",
          "payload": {},
          "origin": null
        }
      ]
    }
  ],
  "entries": [
    {
      "kind": "APPLICATION_CREATED",
      "occurredAt": "2026-10-02T14:21:07.000Z",
      "actorId": null,
      "actorKind": "SYSTEM",
      "payload": {},
      "origin": null
    }
  ]
}

kind es COMMENT o un tipo de evento; payload depende del tipo. actorKind es PERSON, AGENT, CANDIDATE, INTEGRATION, AUTOMATION o SYSTEM, y origin dice por qué puerta entró (APP, API, MCP…).

GET /ats/applications/{applicationId}/stages/{stageId}/feedback

GET/ats/applications/{applicationId}/stages/{stageId}/feedback

Cuenta los comentarios que la postulación tiene en una etapa y cuántos llevan valoración (sentiment). Apoyo de pantalla para el aviso «sin feedback en esta etapa».

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
stageIdstring (uuid)SíId de la etapa.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/stages/e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c/feedback" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{ "comments": 3, "withSentiment": 2 }

PUT /ats/applications/{applicationId}/stage

PUT/ats/applications/{applicationId}/stage

Mueve al candidato a otra etapa del embudo de su vacante y devuelve la postulación. Sólo se mueve un candidato QUALIFIED, y algunas etapas tienen compuertas: la penúltima (presentación al cliente) pide un informe y la última se alcanza contratando con POST …/hire.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
stageIdstring (uuid)SíEtapa de destino, de la misma vacante.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/stage" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stageId":"f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b"}'

Respuesta

{
  "id": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
  "profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
  "jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
  "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
  "origin": "SOURCED",
  "status": "QUALIFIED",
  "disqualifiedReason": null,
  "disqualifiedComment": null,
  "resumeUrl": null,
  "appliedAt": "2026-10-02T14:21:07.000Z"
}

Errores

  • JOB_POST_DRAFT (409): la vacante es un borrador; missing dice qué le falta para publicarse.
  • REPORT_REQUIRED (409): para entrar a la etapa de presentación al cliente hace falta un informe.
  • PLACEMENT_REQUIRED (409): la última etapa se alcanza contratando (POST …/hire), no moviendo.
  • SCREENING_PENDING (409): hay respuestas de screening sin revisar.
  • SCREENING_FAILED (409): el candidato no pasó el screening.
  • SHORTLIST_FIRST (409): hay que pasar por la shortlist antes de contratar.
  • HIRED_IS_FINAL (409): un candidato contratado no se mueve.
  • DO_NOT_CONTACT (409): la persona está marcada como «no contactar».
  • STALE (409): alguien movió o descartó al candidato entre tu lectura y tu escritura.
  • NOT_FOUND (404): la postulación o la etapa no existen.

Acción equivalente: move_application_stage.

PUT /ats/applications/{applicationId}/status

PUT/ats/applications/{applicationId}/status

Cambia el estado del candidato sin moverlo de etapa: descartarlo (DISQUALIFIED), registrar que se retiró (WITHDRAWN) o volver a ponerlo en carrera (QUALIFIED). La etapa queda donde estaba, como registro de hasta dónde llegó.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
statusDISQUALIFIED | QUALIFIED | WITHDRAWNSíEstado nuevo. QUALIFIED vuelve a poner en carrera a alguien descartado o retirado.
reasonenumOpcionalObligatorio con DISQUALIFIED. Uno de: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, OTHER.
commentstringOpcionalHasta 2000 caracteres. Para volver a QUALIFIED desde un descarte es obligatorio, salvo que lo deshaga quien descartó dentro de la ventana de deshacer.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/status" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"DISQUALIFIED","reason":"COMPENSATION_MISMATCH","comment":"Pide un 30% más que el tope de la banda."}'

Respuesta

{
  "id": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
  "profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
  "jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
  "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
  "origin": "SOURCED",
  "status": "DISQUALIFIED",
  "disqualifiedReason": "COMPENSATION_MISMATCH",
  "disqualifiedComment": "Pide un 30% más que el tope de la banda.",
  "resumeUrl": null,
  "appliedAt": "2026-10-02T14:21:07.000Z"
}

Errores

  • REASON_REQUIRED (400): descartar exige reason.
  • COMMENT_REQUIRED (400): volver a calificar un descarte exige comment.
  • HIRED_IS_FINAL (409): un candidato contratado no cambia de estado.
  • NOT_FOUND (404)

Acciones equivalentes: disqualify_application, restore_application, withdraw_application.

POST /ats/applications/{applicationId}/hire

POST/ats/applications/{applicationId}/hire

Contrata al candidato: registra la colocación (placement) y lo lleva a la última etapa en la misma llamada. Lo que no mandes (moneda, período, fee, días de garantía) se hereda de la vacante y de su cliente.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
salarynumberSíSalario acordado, mayor que 0.
startDatestring (YYYY-MM-DD)SíFecha de ingreso.
currencyCodestring (ISO 4217)OpcionalMoneda, p. ej. USD o EUR. Si falta, la de la vacante.
salaryPeriodHOURLY | DAILY | MONTHLY | YEARLYOpcionalPeríodo del salario. Si falta, el de la vacante.
feePctnumber (0–100)OpcionalFee en porcentaje. Si falta, el del cliente.
guaranteeDaysinteger (1–365)OpcionalDías de garantía. Si falta, los del cliente, o 90.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/hire" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"salary":4500,"startDate":"2026-11-03","currencyCode":"USD","salaryPeriod":"MONTHLY"}'

Respuesta

{
  "id": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
  "profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
  "jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
  "stageId": "0d2f4b6c-8e0a-4d2f-b6c8-0e2a4b6d8f0a",
  "origin": "SOURCED",
  "status": "QUALIFIED",
  "disqualifiedReason": null,
  "disqualifiedComment": null,
  "resumeUrl": null,
  "appliedAt": "2026-10-02T14:21:07.000Z"
}

Errores

  • ALREADY_HIRED (409): ya tiene una colocación; termina de moverlo con PUT …/stage.
  • PAY_TERMS_REQUIRED (400): ni el body ni la vacante dicen moneda y período: mándalos en el body.
  • JOB_POST_DRAFT (409): la vacante es un borrador; missing dice qué le falta para publicarse.
  • SCREENING_PENDING (409): hay respuestas de screening sin revisar.
  • SCREENING_FAILED (409): el candidato no pasó el screening.
  • SHORTLIST_FIRST (409): hay que pasar por la shortlist antes de contratar.
  • DO_NOT_CONTACT (409): la persona está marcada como «no contactar».
  • STALE (409): alguien movió o descartó al candidato entre tu lectura y tu escritura.
  • NOT_FOUND (404)

Acción equivalente: move_application_stage.

POST /ats/applications/{applicationId}/guarantee

POST/ats/applications/{applicationId}/guarantee

Registra que una persona contratada se fue. Si la salida cae dentro de la garantía, la activa (y reabre la vacante si estaba cerrada); si no, sólo deja anotada la salida. Se hace una vez por colocación.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
leftAtstring (YYYY-MM-DD)SíFecha en que la persona se fue.
reasonRESIGNED | DISMISSED | OTHERSíMotivo de la salida.
notestringOpcionalNota, hasta 2000 caracteres.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/guarantee" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"leftAt":"2026-09-20","reason":"RESIGNED"}'

Respuesta

{
  "placement": {
    "id": "e5a7c9d1-3f5b-4a7c-a9d1-3f5b7c9d1e3a",
    "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
    "type": "HIRE",
    "salary": 4500,
    "currencyCode": "USD",
    "salaryPeriod": "MONTHLY",
    "feeType": "PERCENTAGE",
    "feePct": 15,
    "feeAmount": null,
    "startDate": "2026-08-01",
    "guaranteeDays": 90,
    "guaranteeEndsAt": "2026-10-30",
    "replacesPlacementId": null,
    "leftAt": "2026-09-20",
    "leftReason": "RESIGNED",
    "leftNote": null,
    "guaranteeActivatedAt": "2026-09-21T10:02:11.000Z",
    "billingStatus": "PENDING",
    "createdAt": "2026-07-25T13:40:00.000Z"
  },
  "outcome": "ACTIVATES",
  "jobPostReopened": true
}

outcome es ACTIVATES (activó la garantía) o RECORDS_EXIT (sólo anotó la salida).

Errores

  • OUTSIDE_GUARANTEE (409): la salida cae fuera de la garantía o la contratación no tiene garantía; no se registra nada.
  • GUARANTEE_ALREADY_USED (409): esa colocación ya registró una salida.
  • NOT_HIRED (409): la persona nunca fue contratada en esta postulación.
  • EXIT_BEFORE_START (400): leftAt es anterior a la fecha de ingreso.

Acción equivalente: activate_guarantee.

POST /ats/applications/match

POST/ats/applications/match

Filtra un conjunto de postulaciones por criterios propios de la postulación (quién las entrevistó, qué contestaron en el screening) y devuelve los ids que pasan. No escribe nada: es POST porque la entrada puede ser muy larga. [] significa que ninguna coincide.

Body

CampoTipoRequeridoDescripción
applicationIdsstring[] (uuid)SíLas postulaciones a filtrar, hasta 5000. La respuesta nunca sale de este conjunto.
filtersobjectSíLos filtros. Sin ninguno, devuelve los mismos ids.
filters.interviewerIdsstring[] (uuid)OpcionalIds de usuario de entrevistadores, hasta 100.
filters.screeningAnswersobject[]OpcionalHasta 20 condiciones sobre respuestas de screening; se exigen todas.

Cada condición de screeningAnswers lleva questionId y un match: unanswered; boolean con value; number con operator (gte, lte, eq, between), value y valueMax opcional; options con operator (any, all, none), options y orUnanswered opcional; o text con text.

curl -X POST "https://app.reclee.com/api/v1/ats/applications/match" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"applicationIds":["5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e","c3e5a7b9-1d3f-4e5a-87b9-1d3f5a7b9c1e"],"filters":{"interviewerIds":["a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"]}}'

Respuesta

["5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e"]

Operaciones en lote

Las operaciones en lote toman hasta 200 postulaciones y contestan fila por fila: applied trae lo que cambió y refused lo que no, cada una con su código ({ id, error }). Una fila rechazada no frena al resto.

PUT /ats/applications/batch/stage

PUT/ats/applications/batch/stage

Mueve varias postulaciones en una llamada, cada una a su etapa. Las compuertas se evalúan por fila: un informe que falta rechaza a ese candidato y mueve al resto.

Body

CampoTipoRequeridoDescripción
movesobject[]SíDe 1 a 200 elementos `{ applicationId, stageId }`.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/batch/stage" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"moves":[{"applicationId":"5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e","stageId":"f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b"},{"applicationId":"c3e5a7b9-1d3f-4e5a-87b9-1d3f5a7b9c1e","stageId":"f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b"}]}'

Respuesta

{
  "applied": [
    {
      "id": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
      "profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
      "jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
      "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
      "origin": "SOURCED",
      "status": "QUALIFIED",
      "disqualifiedReason": null,
      "disqualifiedComment": null,
      "resumeUrl": null,
      "appliedAt": "2026-10-02T14:21:07.000Z"
    }
  ],
  "refused": [{ "id": "c3e5a7b9-1d3f-4e5a-87b9-1d3f5a7b9c1e", "error": "REPORT_REQUIRED" }]
}

Los códigos de refused son los mismos que en PUT …/stage.

Errores

  • JOB_POST_DRAFT (409): la vacante es un borrador; no se mueve nadie.

Acción equivalente: move_applications_stage.

PUT /ats/applications/batch/status

PUT/ats/applications/batch/status

Cambia el estado de varias postulaciones con las mismas reglas que PUT …/status, fila por fila.

Body

CampoTipoRequeridoDescripción
applicationIdsstring[] (uuid)SíDe 1 a 200 postulaciones.
jobPostIdstring (uuid)OpcionalSi lo mandas, una postulación de otra vacante se rechaza en vez de cambiarse.
statusDISQUALIFIED | QUALIFIED | WITHDRAWNSíEstado nuevo. QUALIFIED vuelve a poner en carrera a alguien descartado o retirado.
reasonenumOpcionalObligatorio con DISQUALIFIED. Uno de: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, OTHER.
commentstringOpcionalHasta 2000 caracteres. Para volver a QUALIFIED desde un descarte es obligatorio, salvo que lo deshaga quien descartó dentro de la ventana de deshacer.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/batch/status" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"applicationIds":["5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e","c3e5a7b9-1d3f-4e5a-87b9-1d3f5a7b9c1e"],"status":"DISQUALIFIED","reason":"NOT_RESPONSIVE"}'

Respuesta

{
  "applied": [
    {
      "id": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
      "profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
      "jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
      "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
      "origin": "SOURCED",
      "status": "DISQUALIFIED",
      "disqualifiedReason": "NOT_RESPONSIVE",
      "disqualifiedComment": null,
      "resumeUrl": null,
      "appliedAt": "2026-10-02T14:21:07.000Z"
    }
  ],
  "refused": [{ "id": "c3e5a7b9-1d3f-4e5a-87b9-1d3f5a7b9c1e", "error": "HIRED_IS_FINAL" }]
}

Códigos posibles en refused: NOT_FOUND, INVALID, REASON_REQUIRED, COMMENT_REQUIRED, HIRED_IS_FINAL.

Acción equivalente: set_applications_status.

PATCH /ats/applications/batch/labels

PATCH/ats/applications/batch/labels

Pone etiquetas (por nombre) y saca etiquetas (por id) a varias postulaciones. Es un delta, no un reemplazo: una etiqueta que sólo tienen algunas se conserva.

Body

CampoTipoRequeridoDescripción
applicationIdsstring[] (uuid)SíDe 1 a 200 postulaciones.
jobPostIdstring (uuid)OpcionalSi lo mandas, una postulación de otra vacante se rechaza.
addobject[]OpcionalHasta 20 `{ name, color }` a poner. `name` de 1 a 60 caracteres; `color` opcional. Default `[]`.
removestring[] (uuid)OpcionalHasta 20 ids de etiqueta a sacar. Default `[]`.
createIfMissingbooleanOpcionalCrea las etiquetas que no existan en el workspace. Default `true`.

add y remove no pueden venir vacíos los dos.

curl -X PATCH "https://app.reclee.com/api/v1/ats/applications/batch/labels" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"applicationIds":["5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e","c3e5a7b9-1d3f-4e5a-87b9-1d3f5a7b9c1e"],"add":[{"name":"Esperando respuesta"}]}'

Respuesta

{
  "applied": ["5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e", "c3e5a7b9-1d3f-4e5a-87b9-1d3f5a7b9c1e"],
  "refused": [],
  "labels": [
    {
      "id": "2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e",
      "name": "Esperando respuesta",
      "color": "amber",
      "systemKey": null
    }
  ]
}

applied son los ids de las postulaciones tocadas y labels, las etiquetas en las que se resolvieron los nombres (las nuevas incluidas).

Errores

  • LABEL_NOT_FOUND (404): con createIfMissing: false, un nombre no existe en el workspace.

Acción equivalente: set_applications_labels.

Comentarios

Notas del equipo sobre el proceso del candidato, con un nivel de respuestas. Un comentario raíz puede llevar una valoración (sentiment: GOOD, NEUTRAL, BAD) y se asocia a una etapa; una respuesta no lleva valoración.

GET /ats/applications/{applicationId}/comments

GET/ats/applications/{applicationId}/comments

Lista los comentarios de la postulación, raíces y respuestas, del más viejo al más nuevo.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Pagina: ver Paginación.

curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/comments?page=1&pageSize=50" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "id": "1d3f5a7c-9e1b-4c3d-a5f7-9b1d3f5a7c9e",
      "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
      "parentId": null,
      "sentiment": "GOOD",
      "stageId": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
      "authorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
      "authorName": "Lucía Gómez",
      "body": "Muy buena primera llamada, comunica con claridad.",
      "createdAt": "2026-10-10T15:02:44.000Z",
      "updatedAt": null,
      "deletedAt": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50
}

POST /ats/applications/{applicationId}/comments

POST/ats/applications/{applicationId}/comments

Agrega un comentario raíz o, con parentId, una respuesta a un comentario raíz de la misma postulación. Devuelve el comentario creado.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
bodystringSíTexto, de 1 a 5000 caracteres.
parentIdstring (uuid) | nullOpcionalComentario raíz al que responde. Sin él, es un comentario raíz.
sentimentGOOD | NEUTRAL | BAD | nullOpcionalValoración. No se admite en una respuesta.
stageIdstring (uuid) | nullOpcionalEtapa sobre la que opina. Sin ella, la etapa actual del candidato.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/comments" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"body":"Muy buena primera llamada, comunica con claridad.","sentiment":"GOOD"}'

Respuesta

{
  "id": "1d3f5a7c-9e1b-4c3d-a5f7-9b1d3f5a7c9e",
  "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
  "parentId": null,
  "sentiment": "GOOD",
  "stageId": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
  "authorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
  "authorName": "Lucía Gómez",
  "body": "Muy buena primera llamada, comunica con claridad.",
  "createdAt": "2026-10-10T15:02:44.000Z",
  "updatedAt": null,
  "deletedAt": null
}

Errores

  • INVALID (400): p. ej. una respuesta con sentiment, o un parentId que es una respuesta o es de otra postulación.
  • NOT_FOUND (404): la postulación, la etapa o el comentario padre no existen.

Acciones equivalentes: add_application_comment, reply_to_comment.

PATCH /ats/comments/{commentId}

PATCH/ats/comments/{commentId}

Su autor corrige un comentario: el texto y, en un comentario raíz, la valoración y la etapa (sus respuestas la siguen). Devuelve el comentario.

Parámetros de ruta

CampoTipoRequeridoDescripción
commentIdstring (uuid)SíId del comentario.

Body

CampoTipoRequeridoDescripción
bodystringSíTexto nuevo, de 1 a 5000 caracteres.
sentimentGOOD | NEUTRAL | BAD | nullOpcional`null` la borra; si falta, queda como estaba.
stageIdstring (uuid) | nullOpcionalEtapa nueva de un comentario raíz, de la misma vacante. Si falta, queda.
curl -X PATCH "https://app.reclee.com/api/v1/ats/comments/1d3f5a7c-9e1b-4c3d-a5f7-9b1d3f5a7c9e" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"Muy buena primera llamada; pedir referencias.","sentiment":"NEUTRAL"}'

Respuesta

{
  "id": "1d3f5a7c-9e1b-4c3d-a5f7-9b1d3f5a7c9e",
  "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
  "parentId": null,
  "sentiment": "NEUTRAL",
  "stageId": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
  "authorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
  "authorName": "Lucía Gómez",
  "body": "Muy buena primera llamada; pedir referencias.",
  "createdAt": "2026-10-10T15:02:44.000Z",
  "updatedAt": "2026-10-11T09:12:30.000Z",
  "deletedAt": null
}

Errores

  • NOT_FOUND (404): el comentario no existe o no es tuyo.
  • INVALID (400): p. ej. valoración o etapa en una respuesta.

Acción equivalente: update_application_comment.

DELETE /ats/comments/{commentId}

DELETE/ats/comments/{commentId}

Un comentario sólo lo borra su autor desde la app.

Una API key no borra este recurso: el DELETE contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_application_comment" }]. Usa en su lugar update_application_comment.

Parámetros de ruta

CampoTipoRequeridoDescripción
commentIdstring (uuid)SíId del comentario.
curl -X DELETE "https://app.reclee.com/api/v1/ats/comments/1d3f5a7c-9e1b-4c3d-a5f7-9b1d3f5a7c9e" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (405)

{
  "error": "DELETE_NOT_ALLOWED",
  "allowed": ["PATCH"],
  "suggestions": [{ "tool": "update_application_comment" }]
}

Etiquetas

Una etiqueta marca en qué punto del proceso está un candidato dentro de una vacante («contactado por LinkedIn», «esperando respuesta»). El vocabulario es del workspace; la etiqueta de sistema (systemKey: "IN_CAMPAIGN") no se renombra ni se archiva.

GET /ats/applications/{applicationId}/labels

GET/ats/applications/{applicationId}/labels

Lista las etiquetas que tiene la postulación.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Pagina: ver Paginación.

curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/labels" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "id": "2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e",
      "name": "Esperando respuesta",
      "color": "amber",
      "systemKey": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50
}

POST /ats/applications/{applicationId}/labels

POST/ats/applications/{applicationId}/labels

Pone una etiqueta a la postulación, por nombre. Si el workspace no la tiene, la crea (salvo createIfMissing: false). Devuelve la etiqueta.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
namestringSíNombre, de 1 a 60 caracteres. Se compara sin distinguir mayúsculas.
colorstring | nullOpcionalColor, sólo si la etiqueta se crea: blue, teal, green, amber, orange, rose, purple o slate.
createIfMissingbooleanOpcionalDefault `true`.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/labels" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Esperando respuesta","color":"amber"}'

Respuesta

{
  "id": "2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e",
  "name": "Esperando respuesta",
  "color": "amber",
  "systemKey": null
}

Errores

  • LABEL_NOT_FOUND (404): con createIfMissing: false, el nombre no existe.
  • NOT_FOUND (404)

Acción equivalente: add_application_label.

DELETE /ats/applications/{applicationId}/labels/{labelId}

DELETE/ats/applications/{applicationId}/labels/{labelId}

Saca una etiqueta de la postulación. La etiqueta sigue existiendo en el workspace. Es uno de los pocos DELETE que una API key puede usar.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
labelIdstring (uuid)SíId de la etiqueta.
curl -X DELETE "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/labels/2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

204 No Content, sin cuerpo.

Errores

  • NOT_FOUND (404)

Acción equivalente: remove_application_label.

GET /ats/labels

GET/ats/labels

Lista el vocabulario de etiquetas del workspace, por nombre, cada una con cuántas postulaciones la llevan.

Pagina: ver Paginación.

curl "https://app.reclee.com/api/v1/ats/labels" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "id": "2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e",
      "name": "Esperando respuesta",
      "color": "amber",
      "systemKey": null,
      "applicationCount": 12
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50
}

POST /ats/labels

POST/ats/labels

Crea una etiqueta en el workspace, sin ponérsela a nadie.

Body

CampoTipoRequeridoDescripción
namestringSíNombre, de 1 a 60 caracteres, único en el workspace.
colorstring | nullOpcionalblue, teal, green, amber, orange, rose, purple o slate.
curl -X POST "https://app.reclee.com/api/v1/ats/labels" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"name":"Esperando respuesta","color":"amber"}'

Respuesta

{
  "id": "2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e",
  "name": "Esperando respuesta",
  "color": "amber",
  "systemKey": null
}

Errores

  • NAME_TAKEN (409): ya existe una etiqueta con ese nombre.

PATCH /ats/labels/{labelId}

PATCH/ats/labels/{labelId}

Renombra, cambia el color o archiva una etiqueta. Archivar es definitivo: la etiqueta sale de todas las postulaciones, pero los eventos que la nombran la siguen leyendo.

Parámetros de ruta

CampoTipoRequeridoDescripción
labelIdstring (uuid)SíId de la etiqueta.

Body

CampoTipoRequeridoDescripción
namestringOpcionalNombre nuevo, de 1 a 60 caracteres.
colorstring | nullOpcionalColor nuevo.
archivedtrueOpcionalSólo acepta `true`.
curl -X PATCH "https://app.reclee.com/api/v1/ats/labels/2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sin respuesta"}'

Respuesta

{
  "id": "2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e",
  "name": "Sin respuesta",
  "color": "amber",
  "systemKey": null
}

Errores

  • NAME_TAKEN (409)
  • SYSTEM_LABEL (409): la etiqueta de sistema no se renombra ni se archiva.
  • NOT_FOUND (404)

Acción equivalente: update_label.

DELETE /ats/labels/{labelId}

DELETE/ats/labels/{labelId}

Una etiqueta no se borra: se archiva con PATCH { "archived": true }.

Una API key no borra este recurso: el DELETE contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_label" }]. Usa en su lugar update_label.

Parámetros de ruta

CampoTipoRequeridoDescripción
labelIdstring (uuid)SíId de la etiqueta.
curl -X DELETE "https://app.reclee.com/api/v1/ats/labels/2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (405)

{
  "error": "DELETE_NOT_ALLOWED",
  "allowed": ["PATCH"],
  "suggestions": [{ "tool": "update_label" }]
}

Compatibilidad y match score

La compatibilidad mide al candidato contra los criterios de sourcing de la vacante. scorePct y coveragePct van de 0 a 100: la cobertura dice cuánto del peso de los criterios tuvo datos, y siempre se lee junto al score. Para recalcular, usa la acción run_match_score.

GET /ats/applications/{applicationId}/compatibility

GET/ats/applications/{applicationId}/compatibility

Devuelve el match score vigente con su desglose por criterio, todas las versiones calculadas (la primera es la vigente), el resumen de IA si ya existe y, si el candidato está descartado, el motivo y el criterio que lo dejó afuera. Un criterio sin datos (NO_DATA) aparece igual: es una pregunta para la próxima entrevista.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/compatibility" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "scorePct": 78,
  "coveragePct": 85,
  "verdict": "QUALIFIED",
  "summary": "Cumple los requisitos técnicos; falta confirmar inglés.",
  "evaluatedAt": "2026-10-03T09:15:00.000Z",
  "isCurrent": true,
  "thresholdPct": 70,
  "source": "LINKEDIN",
  "screeningAnswerCount": 1,
  "evaluatedAgainst": { "source": "PUBLIC", "version": null },
  "criteria": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "title": "5+ años con Go",
      "weightPct": 30,
      "required": true,
      "value": "GOOD_FIT",
      "reason": "Siete años con Go en dos empresas.",
      "evidence": "Senior Backend Engineer (Go), 2019–hoy",
      "evidenceSource": "PROFILE"
    },
    {
      "criterionId": "7a9c1e3f-5b7d-4a9c-9e3f-5b7d9a1c3e5f",
      "title": "Inglés avanzado",
      "weightPct": 15,
      "required": false,
      "value": "NO_DATA",
      "reason": "El perfil no menciona idiomas.",
      "evidence": null,
      "evidenceSource": "PROFILE"
    }
  ],
  "versions": [
    {
      "version": 1,
      "createdAt": "2026-10-03T09:15:00.000Z",
      "scorePct": 78,
      "coveragePct": 85,
      "thresholdPct": 70,
      "verdict": "QUALIFIED",
      "summary": "…",
      "source": "LINKEDIN",
      "screeningAnswerCount": 1,
      "cause": "SOURCING",
      "criteria": []
    }
  ],
  "briefing": null,
  "newerCv": false,
  "hasOwnCv": false,
  "pending": false,
  "error": null,
  "disqualification": null
}

value por criterio: GOOD_FIT, FIT, BAD_FIT o NO_DATA. verdict: QUALIFIED, BELOW_THRESHOLD o DISQUALIFIED. isCurrent: false significa que los criterios o las respuestas de screening cambiaron desde el cálculo. Todo es null cuando nadie lo midió (por ejemplo, una carga manual): no es un cero.

Errores

  • NOT_FOUND (404)

GET /ats/applications/{applicationId}/match-score

GET/ats/applications/{applicationId}/match-score

Antes de recalcular: dice qué perfiles hay para leer (el CV propio del candidato, el perfil público), cuál elegiría la regla y si el score vigente ya leyó todo lo que hay (upToDate). No gasta nada.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/match-score" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{ "upToDate": true, "hasOwn": false, "hasPublic": true, "defaultSource": "LINKEDIN" }

Errores

  • NOT_FOUND (404)

Acción equivalente: run_match_score.

POST /ats/applications/{applicationId}/summary

POST/ats/applications/{applicationId}/summary

Devuelve el resumen de IA de la versión vigente del match score: recomendación, brechas y qué preguntar. La primera llamada lo escribe con IA (consume uso); las siguientes devuelven el mismo resumen sin costo.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/summary" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f"

Respuesta

{
  "recommendation": "Avanzar a entrevista técnica: cumple lo excluyente.",
  "gaps": ["No hay datos sobre su nivel de inglés."],
  "whatToAsk": [
    {
      "question": "¿En qué idioma trabajaba tu equipo en tu último empleo?",
      "criterion": "Inglés avanzado"
    }
  ]
}

Errores

  • INVALID (400): no hay ningún cálculo que resumir (por ejemplo, una carga manual sin score).
  • NOT_FOUND (404)
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

Condiciones

Las condiciones son los campos que la vacante pregunta a cada candidato (pretensión salarial, disponibilidad…). Se definen en la vacante (/job-posts/{jobPostId}/conditions) y se contestan por postulación. Un valor puede venir escrito a mano o leído de una entrevista por la IA, que lo deja como propuesta hasta que alguien lo acepta.

GET /ats/applications/{applicationId}/conditions

GET/ats/applications/{applicationId}/conditions

Devuelve todas las condiciones de la vacante con el valor de esta postulación, contestadas o no. Las vacías (value: null) son las que alimentan las preguntas de la próxima entrevista.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/conditions" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

[
  {
    "conditionId": "7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d",
    "label": "Pretensión salarial",
    "hint": "Bruto mensual, en USD",
    "position": 0,
    "value": "<p>4.500 USD brutos mensuales</p>",
    "valueSource": "TYPED",
    "valueInterview": null,
    "proposedValue": null,
    "proposedInterview": null
  }
]

valueSource es TYPED o INTERVIEW. proposedValue es lo que leyó la IA y nadie revisó todavía; espera al lado del valor confirmado, nunca encima.

Errores

  • NOT_FOUND (404)

PUT /ats/applications/{applicationId}/conditions

PUT/ats/applications/{applicationId}/conditions

Escribe a mano el valor de una condición (o lo borra con null). Escribirlo descarta cualquier propuesta pendiente de la IA. Devuelve la lista completa.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
conditionIdstring (uuid)SíCondición de la vacante de esta postulación.
valuestring | nullOpcionalTexto enriquecido (HTML), hasta 4000 caracteres. `null` o vacío lo borra.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/conditions" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conditionId":"7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d","value":"<p>4.500 USD brutos mensuales</p>"}'

Respuesta

[
  {
    "conditionId": "7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d",
    "label": "Pretensión salarial",
    "hint": "Bruto mensual, en USD",
    "position": 0,
    "value": "<p>4.500 USD brutos mensuales</p>",
    "valueSource": "TYPED",
    "valueInterview": null,
    "proposedValue": null,
    "proposedInterview": null
  }
]

Errores

  • NOT_FOUND (404): la condición no es de la vacante de esta postulación.

PUT /ats/applications/{applicationId}/conditions/proposal

PUT/ats/applications/{applicationId}/conditions/proposal

Acepta o descarta el valor que la IA leyó de una entrevista para una condición. Aceptado, pasa a ser el valor (con la entrevista de origen); descartado, queda el valor anterior. Devuelve la lista completa.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
conditionIdstring (uuid)SíLa condición.
acceptbooleanSí`true` acepta, `false` descarta.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/conditions/proposal" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conditionId":"7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d","accept":true}'

Respuesta

[
  {
    "conditionId": "7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d",
    "label": "Pretensión salarial",
    "hint": "Bruto mensual, en USD",
    "position": 0,
    "value": "<p>4.500 USD brutos mensuales</p>",
    "valueSource": "INTERVIEW",
    "valueInterview": "Entrevista técnica",
    "proposedValue": null,
    "proposedInterview": null
  }
]

Errores

  • NOT_FOUND (404): no hay propuesta pendiente para esa condición.

Consideraciones

Lo que el cliente tiene que leer del candidato más allá de los números. kind: REQUIREMENT_EXCEPTION, GAP, RISK, DATA_RELIABILITY, COMPENSATION o HIGHLIGHT. Sólo las CONFIRMED llegan al informe; ninguna se borra: la que no sirve se descarta (DISMISSED).

GET /ats/applications/{applicationId}/considerations

GET/ats/applications/{applicationId}/considerations

Lista las consideraciones de la postulación, en el orden en que se leen en el informe.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/considerations" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

[
  {
    "id": "8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e",
    "kind": "COMPENSATION",
    "status": "CONFIRMED",
    "title": "Pretensión por encima de la banda",
    "body": "<p>Pide un 10% más que el tope de la banda; abierto a negociar con bono.</p>",
    "position": 0,
    "source": "MANUAL"
  }
]

status: PROPOSED, CONFIRMED o DISMISSED. source: MANUAL (escrita por una persona), AI_GENERATED o AI_EDITED (propuesta por la IA, editada después).

POST /ats/applications/{applicationId}/considerations

POST/ats/applications/{applicationId}/considerations

Escribe una consideración nueva. Todas se publican al cliente cuando se confirman: no hay consideraciones internas.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
kindenumSíREQUIREMENT_EXCEPTION, GAP, RISK, DATA_RELIABILITY, COMPENSATION o HIGHLIGHT.
titlestringSíTítulo, de 1 a 200 caracteres.
bodystringSíTexto enriquecido (HTML), de 1 a 8000 caracteres.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/considerations" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"kind":"COMPENSATION","title":"Pretensión por encima de la banda","body":"<p>Pide un 10% más que el tope de la banda.</p>"}'

Respuesta

{
  "id": "8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e",
  "kind": "COMPENSATION",
  "status": "CONFIRMED",
  "title": "Pretensión por encima de la banda",
  "body": "<p>Pide un 10% más que el tope de la banda; abierto a negociar con bono.</p>",
  "position": 0,
  "source": "MANUAL"
}

Errores

  • NOT_FOUND (404)

Acción equivalente: write_consideration.

PUT /ats/applications/{applicationId}/considerations/reorder

PUT/ats/applications/{applicationId}/considerations/reorder

Reordena las consideraciones. Recibe la lista completa de ids en el orden nuevo: la primera es la que el cliente lee primero. Devuelve la lista reordenada.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
idsstring[] (uuid)SíTodos los ids de consideraciones de la postulación, en orden.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/considerations/reorder" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e","9a0c2e4a-6b8d-4a0c-ae4a-6b8d0a2c4e6b"]}'

Respuesta

[
  {
    "id": "8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e",
    "kind": "COMPENSATION",
    "status": "CONFIRMED",
    "title": "Pretensión por encima de la banda",
    "body": "<p>Pide un 10% más que el tope de la banda; abierto a negociar con bono.</p>",
    "position": 0,
    "source": "MANUAL"
  }
]

Errores

  • INCOMPLETE (400): la lista no trae todas las consideraciones.
  • NOT_FOUND (404)

PATCH /ats/considerations/{considerationId}

PATCH/ats/considerations/{considerationId}

Edita una consideración o cambia su estado: confirmarla la lleva al informe y descartarla la saca sin borrarla. No hay DELETE. Reescribir una propuesta de la IA la marca como AI_EDITED.

Parámetros de ruta

CampoTipoRequeridoDescripción
considerationIdstring (uuid)SíId de la consideración.

Body

CampoTipoRequeridoDescripción
kindenumOpcionalTipo nuevo.
titlestringOpcionalDe 1 a 200 caracteres.
bodystringOpcionalHTML, de 1 a 8000 caracteres.
statusPROPOSED | CONFIRMED | DISMISSEDOpcionalEstado nuevo.

Hace falta al menos un campo; el orden se cambia con …/considerations/reorder.

curl -X PATCH "https://app.reclee.com/api/v1/ats/considerations/8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"CONFIRMED"}'

Respuesta

{
  "id": "8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e",
  "kind": "COMPENSATION",
  "status": "CONFIRMED",
  "title": "Pretensión por encima de la banda",
  "body": "<p>Pide un 10% más que el tope de la banda; abierto a negociar con bono.</p>",
  "position": 0,
  "source": "MANUAL"
}

Errores

  • INVALID (400): body vacío.
  • NOT_FOUND (404)

Scorecard

El scorecard puntúa al candidato de 1 a 5 contra los criterios de evaluación de la vacante. Una fila sin puntaje está pendiente (no hay N/A), y el resultado es el promedio ponderado (HIGH 3, MEDIUM 2, LOW 1) sobre las filas puntuadas. Sólo el evaluador asignado puntúa; el primero que puntúa una postulación sin evaluador queda asignado. Lo que propone la IA espera al lado de cada fila y no cuenta hasta que alguien lo adopta.

GET /ats/applications/{applicationId}/scorecard

GET/ats/applications/{applicationId}/scorecard

Devuelve el scorecard: una fila por criterio de la vacante (puntuado o no), el resultado, el porcentaje, la recomendación y su texto.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "description": "Versionado, errores y contratos estables",
      "weightLevel": "HIGH",
      "position": 0,
      "score": 4,
      "comment": "<p>Explicó bien cómo versiona sus APIs.</p>",
      "source": "MANUAL",
      "quote": null,
      "interviewId": null,
      "proposal": null
    }
  ],
  "result": 4,
  "percentage": 0.75,
  "partial": true,
  "scoredCount": 1,
  "totalCount": 4,
  "proposalCount": 0,
  "recommendationThreshold": 3.5,
  "recommendation": "RECOMMENDED",
  "rationale": null,
  "rationaleSource": "MANUAL",
  "rationaleProposal": null,
  "evaluatorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"
}

result es el promedio sobre 5 (null sin filas puntuadas) y percentage es (result - 1) / 4, de 0 a 1. partial es true mientras quede alguna fila pendiente. recommendation: STRONGLY_RECOMMENDED, RECOMMENDED, RECOMMENDED_WITH_RESERVATIONS o NOT_RECOMMENDED, según recommendationThreshold.

Errores

  • NOT_FOUND (404)

GET /ats/applications/{applicationId}/evaluation

GET/ats/applications/{applicationId}/evaluation

Lo que muestra la pestaña Evaluación del candidato, en una sola llamada: el scorecard y las consideraciones.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/evaluation" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "scorecard": {
    "rows": [],
    "result": 4,
    "percentage": 0.75,
    "partial": true,
    "scoredCount": 1,
    "totalCount": 4,
    "recommendation": "RECOMMENDED"
  },
  "considerations": {
    "ok": true,
    "data": [
      {
        "id": "8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e",
        "kind": "COMPENSATION",
        "status": "CONFIRMED",
        "title": "Pretensión por encima de la banda",
        "position": 0,
        "source": "MANUAL"
      }
    ]
  }
}

scorecard tiene la forma de GET .../scorecard. considerations trae su propio resultado: { "ok": true, "data": [...] } con la forma de GET .../considerations, o { "ok": false, "error": "<código>" } si no se pudieron leer; ese fallo no oculta el scorecard.

Errores

  • NOT_FOUND (404)

PUT /ats/applications/{applicationId}/scorecard

PUT/ats/applications/{applicationId}/scorecard

Puntúa o comenta un criterio, uno por llamada. Devuelve el scorecard completo.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
criterionIdstring (uuid)SíCriterio de evaluación de la vacante.
scoreinteger (1–5) | nullOpcionalPuntaje; `null` lo deja pendiente.
commentstring | nullOpcionalHTML, hasta 8000 caracteres.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"criterionId":"6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c","score":4,"comment":"<p>Explicó bien cómo versiona sus APIs.</p>"}'

Respuesta

{
  "rows": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "description": "Versionado, errores y contratos estables",
      "weightLevel": "HIGH",
      "position": 0,
      "score": 4,
      "comment": "<p>Explicó bien cómo versiona sus APIs.</p>",
      "source": "MANUAL",
      "quote": null,
      "interviewId": null,
      "proposal": null
    }
  ],
  "result": 4,
  "percentage": 0.75,
  "partial": true,
  "scoredCount": 1,
  "totalCount": 4,
  "proposalCount": 0,
  "recommendationThreshold": 3.5,
  "recommendation": "RECOMMENDED",
  "rationale": null,
  "rationaleSource": "MANUAL",
  "rationaleProposal": null,
  "evaluatorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"
}

Errores

  • NOT_EVALUATOR (403): la postulación tiene otro evaluador asignado.
  • NOT_FOUND (404)

PUT /ats/applications/{applicationId}/scorecard/evaluator

PUT/ats/applications/{applicationId}/scorecard/evaluator

Asigna el evaluador de la postulación, o la deja sin evaluador con null. Devuelve el scorecard.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
evaluatorIdstring (uuid) | nullSíId de usuario de un miembro del workspace, o `null`.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/evaluator" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"evaluatorId":"a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"}'

Respuesta

{
  "rows": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "description": "Versionado, errores y contratos estables",
      "weightLevel": "HIGH",
      "position": 0,
      "score": 4,
      "comment": "<p>Explicó bien cómo versiona sus APIs.</p>",
      "source": "MANUAL",
      "quote": null,
      "interviewId": null,
      "proposal": null
    }
  ],
  "result": 4,
  "percentage": 0.75,
  "partial": true,
  "scoredCount": 1,
  "totalCount": 4,
  "proposalCount": 0,
  "recommendationThreshold": 3.5,
  "recommendation": "RECOMMENDED",
  "rationale": null,
  "rationaleSource": "MANUAL",
  "rationaleProposal": null,
  "evaluatorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"
}

Errores

  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/scorecard/draft

POST/ats/applications/{applicationId}/scorecard/draft

La IA propone la evaluación a partir de todo lo que dieron las entrevistas (transcripciones, respuestas confirmadas, notas) y las condiciones: puntaje y comentario por criterio, consideraciones y el texto de la recomendación. Todo llega como propuesta; las filas ya puntuadas por una persona no se tocan. Consume uso.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/draft" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f"

Respuesta (extracto)

{
  "rows": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "description": "Versionado, errores y contratos estables",
      "weightLevel": "HIGH",
      "position": 0,
      "score": null,
      "comment": null,
      "source": "MANUAL",
      "quote": null,
      "interviewId": null,
      "proposal": {
        "score": 4,
        "comment": "Describe migraciones con versionado explícito.",
        "quote": "siempre versionamos por header…",
        "interviewId": "3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b",
        "state": "PROPOSED"
      }
    }
  ],
  "result": 4,
  "percentage": 0.75,
  "partial": true,
  "scoredCount": 1,
  "totalCount": 4,
  "proposalCount": 1,
  "recommendationThreshold": 3.5,
  "recommendation": "RECOMMENDED",
  "rationale": null,
  "rationaleSource": "MANUAL",
  "rationaleProposal": null,
  "evaluatorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"
}

Errores

  • NO_CRITERIA (409): la vacante no tiene criterios de evaluación.
  • NO_EVIDENCE (409): no hay entrevistas con transcripción, respuestas ni notas de donde leer.
  • NOT_FOUND (404)
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

Acción equivalente: generate_scorecard.

POST /ats/applications/{applicationId}/scorecard/instruction

POST/ats/applications/{applicationId}/scorecard/instruction

Aplica una indicación en lenguaje natural sobre puntajes y comentarios y devuelve el diff. No guarda nada: cada cambio se acepta con PUT …/scorecard sobre ese criterio. Nunca toca los criterios. Consume uso.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
instructionstringSíUna indicación, de 3 a 1000 caracteres.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/instruction" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"instruction":"Sé más concreto en los comentarios técnicos."}'

Respuesta

{
  "instruction": "Sé más concreto en los comentarios técnicos.",
  "changes": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "field": "comment",
      "current": "Explicó bien cómo versiona sus APIs.",
      "proposed": "Versiona por header y documenta deprecaciones con dos releases de aviso.",
      "rationale": "Cita el ejemplo concreto de la entrevista."
    }
  ],
  "tokens": 812
}

Errores

  • NOTHING_SCORED (409): no hay filas puntuadas sobre las que aplicar la indicación.
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

POST /ats/applications/{applicationId}/scorecard/proposals

POST/ats/applications/{applicationId}/scorecard/proposals

Adopta la propuesta de la IA para una fila, tal cual o con tus cambios de puntaje o comentario. Sólo el evaluador. Devuelve el scorecard.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
criterionIdstring (uuid)SíLa fila.
scoreinteger (1–5)OpcionalPuntaje distinto al propuesto.
commentstring | nullOpcionalComentario distinto al propuesto, hasta 8000 caracteres.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/proposals" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"criterionId":"6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c"}'

Respuesta

{
  "rows": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "description": "Versionado, errores y contratos estables",
      "weightLevel": "HIGH",
      "position": 0,
      "score": 4,
      "comment": "<p>Explicó bien cómo versiona sus APIs.</p>",
      "source": "MANUAL",
      "quote": null,
      "interviewId": null,
      "proposal": null
    }
  ],
  "result": 4,
  "percentage": 0.75,
  "partial": true,
  "scoredCount": 1,
  "totalCount": 4,
  "proposalCount": 0,
  "recommendationThreshold": 3.5,
  "recommendation": "RECOMMENDED",
  "rationale": null,
  "rationaleSource": "MANUAL",
  "rationaleProposal": null,
  "evaluatorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"
}

Errores

  • NOT_EVALUATOR (403): la postulación tiene otro evaluador asignado.
  • NOT_FOUND (404)

PATCH /ats/applications/{applicationId}/scorecard/proposals

PATCH/ats/applications/{applicationId}/scorecard/proposals

Descarta la propuesta de una fila (DISMISSED) o la recupera (PROPOSED). Devuelve el scorecard.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
criterionIdstring (uuid)SíLa fila.
statePROPOSED | DISMISSEDSíEstado nuevo de la propuesta.
curl -X PATCH "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/proposals" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"criterionId":"6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c","state":"DISMISSED"}'

Respuesta

{
  "rows": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "description": "Versionado, errores y contratos estables",
      "weightLevel": "HIGH",
      "position": 0,
      "score": 4,
      "comment": "<p>Explicó bien cómo versiona sus APIs.</p>",
      "source": "MANUAL",
      "quote": null,
      "interviewId": null,
      "proposal": null
    }
  ],
  "result": 4,
  "percentage": 0.75,
  "partial": true,
  "scoredCount": 1,
  "totalCount": 4,
  "proposalCount": 0,
  "recommendationThreshold": 3.5,
  "recommendation": "RECOMMENDED",
  "rationale": null,
  "rationaleSource": "MANUAL",
  "rationaleProposal": null,
  "evaluatorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"
}

Errores

  • NOT_EVALUATOR (403): la postulación tiene otro evaluador asignado.
  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/scorecard/proposals/all

POST/ats/applications/{applicationId}/scorecard/proposals/all

Adopta tal cual todas las propuestas pendientes que traen puntaje. Sólo el evaluador. Sin body.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/proposals/all" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs",
      "description": "Versionado, errores y contratos estables",
      "weightLevel": "HIGH",
      "position": 0,
      "score": 4,
      "comment": "<p>Explicó bien cómo versiona sus APIs.</p>",
      "source": "MANUAL",
      "quote": null,
      "interviewId": null,
      "proposal": null
    }
  ],
  "result": 4,
  "percentage": 0.75,
  "partial": true,
  "scoredCount": 1,
  "totalCount": 4,
  "proposalCount": 0,
  "recommendationThreshold": 3.5,
  "recommendation": "RECOMMENDED",
  "rationale": null,
  "rationaleSource": "MANUAL",
  "rationaleProposal": null,
  "evaluatorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"
}

Errores

  • NOT_EVALUATOR (403): la postulación tiene otro evaluador asignado.
  • NOT_FOUND (404)

PUT /ats/applications/{applicationId}/scorecard/rationale

PUT/ats/applications/{applicationId}/scorecard/rationale

Guarda el párrafo que explica la recomendación, el que firma una persona y cierra el informe. Vacío lo borra. Devuelve el texto guardado, o null si quedó vacío.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
rationalestringSíHTML, hasta 8000 caracteres. `""` lo borra.
curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/rationale" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rationale":"<p>Sólido en diseño de APIs y con experiencia liderando migraciones.</p>"}'

Respuesta

"<p>Sólido en diseño de APIs y con experiencia liderando migraciones.</p>"

Errores

  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/scorecard/rationale/proposal

POST/ats/applications/{applicationId}/scorecard/rationale/proposal

Adopta o descarta el texto de recomendación que propuso la IA.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
acceptbooleanSí`true` lo adopta, `false` lo descarta.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/scorecard/rationale/proposal" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accept":true}'

Respuesta

{
  "rationale": "<p>Sólido en diseño de APIs y con experiencia liderando migraciones.</p>",
  "source": "AI_GENERATED",
  "proposal": null
}

Errores

  • NOT_FOUND (404): no hay texto propuesto.

Informe

El informe es el documento que lee el cliente sobre el candidato. Se arma por versiones: cada cambio deja una versión nueva y el link compartido muestra la última. Para armarlo hace falta el scorecard completo, todas las consideraciones revisadas y el texto de la recomendación escrito (ver …/report/readiness). Lo que propone la IA (proposals, textProposals) nunca llega al link del cliente hasta que alguien lo adopta. Las escrituras devuelven la versión nueva completa (CandidateReport).

GET /ats/applications/{applicationId}/report

GET/ats/applications/{applicationId}/report

Devuelve la última versión del informe, con su contenido, o null si nunca se armó.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 3,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    },
    "summary": null,
    "recommendation": {
      "label": "RECOMMENDED",
      "result": 4,
      "screeningExceptions": 0,
      "rationale": "<p>Sólido en diseño de APIs y con experiencia liderando migraciones.</p>"
    },
    "screening": [
      {
        "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
        "title": "5+ años con Go",
        "required": true,
        "outcome": "PASS",
        "rationale": "<p>7 años con Go en dos empresas.</p>",
        "interviewName": null
      }
    ],
    "evaluation": [
      {
        "key": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
        "name": "Diseño de APIs",
        "weightLevel": "HIGH",
        "score": 4,
        "comment": "<p>Explicó bien cómo versiona sus APIs.</p>",
        "quote": null
      }
    ],
    "profile": {
      "source": "LINKEDIN",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "location": "Madrid, España",
      "linkedinUrl": "https://www.linkedin.com/in/martin-ruiz-example",
      "positions": [],
      "education": [],
      "projects": [],
      "skills": ["Go", "PostgreSQL", "Kubernetes"],
      "languages": [{ "name": "Inglés", "proficiency": "PROFESSIONAL_WORKING" }]
    },
    "considerations": [
      {
        "key": "8f0b2d4e-6a8c-4f0b-82d4-6a8c0f2b4d6e",
        "kind": "COMPENSATION",
        "title": "Pretensión por encima de la banda",
        "body": "<p>Pide un 10% más que el tope.</p>"
      }
    ],
    "conditions": [
      {
        "key": "7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d",
        "label": "Pretensión salarial",
        "value": "<p>4.500 USD brutos mensuales</p>"
      }
    ]
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "EDITED",
  "changedBlock": "recommendation",
  "shortlistedAt": null
}

change dice qué hizo la versión (GENERATED, EDITED, REFRESHED, CONFIRMED) y changedBlock, en qué bloque. content.screening[].outcome es PASS, FAIL, ANSWERED_IN_INTERVIEW o UNRESOLVED. Un informe viejo puede no traer bloques agregados después (por ejemplo profile.projects): léelos como opcionales.

Errores

  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/report

POST/ats/applications/{applicationId}/report

Arma una versión nueva del informe sin IA y sin costo: copia la recomendación, el scorecard, las consideraciones revisadas, las condiciones y el perfil tal como están. Lo que redacta la IA va por …/report/draft. Sin body.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f"

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 4,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "GENERATED",
  "changedBlock": null,
  "shortlistedAt": null
}

Errores

  • NOT_READY (409): falta algo para armarlo; GET …/report/readiness dice qué.
  • NOT_FOUND (404)

Acción equivalente: generate_report.

GET /ats/applications/{applicationId}/report/readiness

GET/ats/applications/{applicationId}/report/readiness

Dice si el informe se puede armar y, si no, qué falta: las tres compuertas (scorecard, consideraciones, recomendación) con su contador, la lista de pendientes y las ejecuciones de IA que están escribiendo el informe en este momento.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/readiness" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "ready": false,
  "scorecard": { "ready": false, "done": 3, "total": 4 },
  "considerations": { "ready": true, "done": 2, "total": 2 },
  "recommendation": { "ready": false, "done": 0, "total": 1 },
  "missing": [
    {
      "kind": "CRITERION",
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "name": "Diseño de APIs"
    },
    { "kind": "RECOMMENDATION" }
  ],
  "generations": []
}

missing[].kind: NO_CRITERIA, CRITERION, CONSIDERATION o RECOMMENDATION. generations[] trae { scope, startedAt }, donde scope es report o un bloque.

Errores

  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/report/draft

POST/ats/applications/{applicationId}/report/draft

La IA propone los textos del informe ya armado: perfil narrativo, recomendación, un PASS o FAIL por requisito, comentarios de la evaluación, consideraciones y condiciones. Todo texto vacío recibe una propuesta, y uno escrito sólo si la IA lo cambiaría. Con block, propone sólo ese bloque. Las propuestas se adoptan o descartan con …/report/proposals y …/report/requirements. Consume uso.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
blockenumOpcionalrecommendation, requirements, evaluation, profile, considerations o conditions. Sin él, todos.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/draft" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"block":"requirements"}'

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 3,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [
    {
      "criterionId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "title": "5+ años con Go",
      "required": true,
      "outcome": "PASS",
      "rationale": "Siete años con Go en dos empresas.",
      "source": "PROFILE",
      "interviewName": null
    }
  ],
  "textProposals": { "recommendation": "<p>Recomendado: cumple todo lo excluyente.</p>" },
  "contentLocale": "es",
  "change": "EDITED",
  "changedBlock": "recommendation",
  "shortlistedAt": null
}

Errores

  • REPORT_IN_PROGRESS (409): otra ejecución de IA está escribiendo este informe.
  • NOT_FOUND (404): no hay informe armado.
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

Acción equivalente: draft_report.

PATCH /ats/applications/{applicationId}/report/blocks

PATCH/ats/applications/{applicationId}/report/blocks

Corrige un texto del informe sobre el propio informe. Cada escritura sobre el informe crea una versión nueva; ninguna se reescribe.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
blockenumSírecommendation, profile, evaluation, considerations, conditions o requirements. Define qué otros campos van.
rowinteger ≥ 0OpcionalPosición de la fila en la versión vigente. Obligatorio en evaluation, considerations, conditions y requirements.
textstringOpcionalrecommendation: el texto (HTML, hasta 8000).
summarystringOpcionalprofile: el perfil narrativo.
commentstringOpcionalevaluation: el comentario de la fila.
title / bodystringOpcionalconsiderations: `title` opcional (1–200) y `body`.
valuestringOpcionalconditions: el valor.
outcome / rationalePASS | FAIL, stringOpcionalrequirements: `outcome` opcional y `rationale` (no vacío).
curl -X PATCH "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/blocks" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"block":"considerations","row":0,"body":"<p>Pide un 10% más que el tope; acepta bono por objetivos.</p>"}'

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 5,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "EDITED",
  "changedBlock": "considerations",
  "shortlistedAt": null
}

Errores

  • NOT_FOUND (404): no hay informe o no existe esa fila.
  • INVALID (400)

POST /ats/applications/{applicationId}/report/blocks

POST/ats/applications/{applicationId}/report/blocks

Pone al día un bloque del informe desde donde se trabaja (el scorecard, las consideraciones, las condiciones, el perfil), sin IA y sin costo. Los textos corregidos sobre el informe se conservan. Cada escritura sobre el informe crea una versión nueva; ninguna se reescribe.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
blockenumSírecommendation, evaluation, profile, considerations o conditions.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/blocks" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"block":"evaluation"}'

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 5,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "REFRESHED",
  "changedBlock": "evaluation",
  "shortlistedAt": null
}

Errores

  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/report/proposals

POST/ats/applications/{applicationId}/report/proposals

Adopta (tal cual o corregido con text) o descarta un texto que propuso la IA: el perfil narrativo, la recomendación o una fila de la evaluación, las consideraciones o las condiciones. Cada escritura sobre el informe crea una versión nueva; ninguna se reescribe.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
blockenumSírecommendation, evaluation, profile, considerations o conditions.
rowinteger ≥ 0OpcionalObligatorio en evaluation, considerations y conditions; no se admite en los demás.
acceptbooleanSí`true` adopta, `false` descarta.
textstringOpcionalVersión corregida del texto (HTML, hasta 8000).
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/proposals" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"block":"recommendation","accept":true}'

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 5,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "CONFIRMED",
  "changedBlock": "recommendation",
  "shortlistedAt": null
}

Errores

  • NOT_FOUND (404): no hay propuesta para ese bloque o fila.
  • INVALID (400)

POST /ats/applications/{applicationId}/report/requirements

POST/ats/applications/{applicationId}/report/requirements

Confirma un requisito que propuso la IA, tal cual o corregido. Cada escritura sobre el informe crea una versión nueva; ninguna se reescribe.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
criterionIdstring (uuid)SíCriterio de sourcing del requisito.
outcomePASS | FAILOpcionalResultado distinto al propuesto.
rationalestringOpcionalFundamento corregido, de 1 a 600 caracteres.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/requirements" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"criterionId":"6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c"}'

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 5,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "CONFIRMED",
  "changedBlock": "requirements",
  "shortlistedAt": null
}

Errores

  • NOT_FOUND (404): no hay propuesta para ese criterio.

PATCH /ats/applications/{applicationId}/report/requirements

PATCH/ats/applications/{applicationId}/report/requirements

Descarta un requisito que propuso la IA. Una fila ya confirmada para ese criterio queda como estaba.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
criterionIdstring (uuid)SíCriterio del requisito.
stateDISMISSEDSíSólo acepta `DISMISSED`.
curl -X PATCH "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/requirements" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"criterionId":"6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c","state":"DISMISSED"}'

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 3,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "EDITED",
  "changedBlock": "recommendation",
  "shortlistedAt": null
}

Errores

  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/report/requirements/all

POST/ats/applications/{applicationId}/report/requirements/all

Confirma tal cual todos los requisitos que siguen propuestos. Sin body. Cada escritura sobre el informe crea una versión nueva; ninguna se reescribe.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/requirements/all" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 5,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "CONFIRMED",
  "changedBlock": "requirements",
  "shortlistedAt": null
}

Errores

  • NOT_FOUND (404)

GET /ats/applications/{applicationId}/report/versions

GET/ats/applications/{applicationId}/report/versions

Lista las versiones del informe, de la más nueva a la más vieja, sin contenido: sirve para ubicarse. El contenido de una versión se lee con …/report/versions/{version}.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Pagina: ver Paginación.

curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/versions" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
      "version": 3,
      "generatedAt": "2026-10-16T12:00:00.000Z",
      "contentLocale": "es",
      "change": "EDITED",
      "changedBlock": "recommendation"
    },
    {
      "id": "a2c4e6f8-0b2d-4c4e-86f8-0b2d4c6e8a0c",
      "version": 2,
      "generatedAt": "2026-10-15T18:30:00.000Z",
      "contentLocale": "es",
      "change": "GENERATED",
      "changedBlock": null
    }
  ],
  "total": 2,
  "page": 1,
  "pageSize": 50
}

GET /ats/applications/{applicationId}/report/versions/{version}

GET/ats/applications/{applicationId}/report/versions/{version}

Devuelve una versión del informe con su contenido, tal como quedó congelada, o null si ese número no existe.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
versioninteger ≥ 1SíNúmero de versión.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/versions/2" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "id": "d4f6b8c0-2e4a-4f6b-98c0-2e4a6b8c0d2f",
  "version": 2,
  "content": {
    "header": {
      "candidateName": "Martín Ruiz",
      "headline": "Backend Engineer · Go, PostgreSQL",
      "jobPostTitle": "Backend Engineer Sr.",
      "generatedAt": "2026-10-16T12:00:00.000Z"
    }
  },
  "generatedAt": "2026-10-16T12:00:00.000Z",
  "proposals": [],
  "textProposals": {},
  "contentLocale": "es",
  "change": "GENERATED",
  "changedBlock": null,
  "shortlistedAt": null
}

Errores

  • INVALID (400): version no es un entero mayor o igual a 1.

POST /ats/applications/{applicationId}/report/translation

POST/ats/applications/{applicationId}/report/translation

Devuelve el contenido de una versión en el idioma pedido. En su propio idioma vuelve tal cual; si ya se tradujo antes, se lee de nuevo sin costo; si no, se traduce con IA (consume uso) y se guarda con la versión.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
versioninteger ≥ 1SíVersión a traducir.
localeenumSíIdioma: es, en, pt, fr, de, it.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/translation" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"version":3,"locale":"en"}'

Respuesta (extracto)

{
  "header": {
    "candidateName": "Martín Ruiz",
    "headline": "Backend Engineer · Go, PostgreSQL",
    "jobPostTitle": "Backend Engineer Sr.",
    "generatedAt": "2026-10-16T12:00:00.000Z"
  },
  "summary": null,
  "recommendation": {
    "label": "RECOMMENDED",
    "result": 4,
    "screeningExceptions": 0,
    "rationale": "<p>Strong in API design, with experience leading migrations.</p>"
  }
}

Devuelve sólo el contenido (la misma forma que content de una versión), no la versión entera.

Errores

  • NOT_FOUND (404): no existe esa versión.
  • FORBIDDEN (403): tu rol no puede escribir; descarga el informe en su idioma.
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

GET /ats/applications/{applicationId}/report/download-sources

GET/ats/applications/{applicationId}/report/download-sources

Apoyo de pantalla para las opciones del PDF: los perfiles con los que se puede escribir la sección de perfil completo (WORKSPACE, CV, LINKEDIN; null donde no hay), el que elegiría la regla y los contactos que el workspace ya tiene. Nunca busca contactos nuevos.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/download-sources" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "profiles": {
    "WORKSPACE": null,
    "CV": null,
    "LINKEDIN": {
      "headline": "Backend Engineer · Go, PostgreSQL",
      "location": "Madrid, España",
      "summary": null,
      "positions": [],
      "education": [],
      "projects": [],
      "skills": ["Go"],
      "languages": []
    }
  },
  "defaultSource": "LINKEDIN",
  "contacts": { "emails": ["martin.ruiz@example.com"], "phones": [] }
}

Errores

  • NOT_FOUND (404)

POST /ats/applications/{applicationId}/report/downloads

POST/ats/applications/{applicationId}/report/downloads

Registra que se descargó el PDF de una versión con ciertas opciones; deja el evento en la historia de la postulación. El PDF en sí lo arma la app.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
versioninteger ≥ 1SíVersión descargada.
localeenumSíIdioma: es, en, pt, fr, de, it.
profileSourceWORKSPACE | CV | LINKEDIN | nullSíDe qué perfil salió la sección de perfil completo, o `null` sin ella.
contactbooleanSíSi el PDF incluyó los datos de contacto.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/report/downloads" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"version":3,"locale":"es","profileSource":null,"contact":false}'

Respuesta

true

Errores

  • NOT_FOUND (404)

Screening

Las respuestas del candidato a las preguntas de screening de la vacante (las del formulario del sitio de empleo, o las que un reclutador anota a mano o toma en una entrevista de screening). Una pregunta eliminatoria (isKnockout) que no se cumple descarta; una respuesta de texto la lee la IA y espera la confirmación de una persona.

GET /ats/applications/{applicationId}/screening

GET/ats/applications/{applicationId}/screening

Devuelve el screening de la postulación: el veredicto, los contadores, las respuestas registradas y una fila por cada pregunta que la vacante tiene hoy, contestada o no.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/screening" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "verdict": "PASSED",
  "questionCount": 2,
  "answeredCount": 1,
  "failedCount": 0,
  "pendingReviewCount": 0,
  "answers": [
    {
      "id": "0b2d4f6a-8c0e-4b2d-b4f6-8c0e2b4d6f8a",
      "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
      "screeningQuestionId": "9a1c3e5f-7b9d-4a1c-a3e5-7b9d1a3c5e7f",
      "type": "BOOLEAN",
      "isKnockout": true,
      "prompt": "¿Tienes permiso de trabajo en España?",
      "questionSnapshot": { "type": "BOOLEAN", "isKnockout": true, "expectedBoolean": true },
      "answerBoolean": true,
      "answerNumber": null,
      "answerNumberMax": null,
      "answerOptions": [],
      "answerText": null,
      "passed": true,
      "review": "CONFIRMED",
      "origin": "FORM",
      "interviewId": null,
      "resolvedBy": "COMPARISON",
      "aiReading": null,
      "reviewedBy": null,
      "reviewedAt": null,
      "overrideReason": null,
      "answeredAt": "2026-10-02T14:21:07.000Z"
    }
  ],
  "rows": [
    {
      "questionId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "type": "NUMBER",
      "prompt": "¿Cuántos años de experiencia tienes con Go?",
      "isKnockout": false,
      "isRequired": true,
      "options": [],
      "expectation": { "type": "NUMBER", "isKnockout": false, "numberOperator": "GTE", "numberValue": 5 },
      "answer": null
    }
  ]
}

verdict: NOT_SCREENED, FAILED, NEEDS_REVIEW o PASSED. En rows, answer: null es una pregunta sin contestar: un hueco, nunca un fallo. origin de una respuesta: FORM, INTERVIEW o MANUAL.

Errores

  • NOT_FOUND (404)

PUT /ats/applications/{applicationId}/screening

PUT/ats/applications/{applicationId}/screening

Anota una respuesta de screening a mano o tomada en una entrevista de screening. Reemplaza la que hubiera para esa pregunta. Devuelve el screening completo.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
questionIdstring (uuid)SíPregunta de screening de la vacante.
originMANUAL | INTERVIEWSíDe dónde sale la respuesta.
interviewIdstring (uuid) | nullOpcionalObligatorio con INTERVIEW, y sólo con INTERVIEW.
valueobjectSíLa respuesta, con la forma del tipo de pregunta (ver abajo).

value según type: BOOLEAN con answerBoolean; NUMBER con answerNumber; RANGE con answerNumber y answerNumberMax (de menor a mayor); SINGLE_SELECT con answerOptions (exactamente una); MULTI_SELECT con answerOptions (1 a 20); TEXT con answerText (1 a 4000 caracteres).

curl -X PUT "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/screening" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"questionId":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d","origin":"MANUAL","value":{"type":"NUMBER","answerNumber":7}}'

Respuesta (extracto)

{
  "verdict": "PASSED",
  "questionCount": 2,
  "answeredCount": 2,
  "failedCount": 0,
  "pendingReviewCount": 0,
  "answers": [
    {
      "id": "0b2d4f6a-8c0e-4b2d-b4f6-8c0e2b4d6f8a",
      "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
      "screeningQuestionId": "9a1c3e5f-7b9d-4a1c-a3e5-7b9d1a3c5e7f",
      "type": "BOOLEAN",
      "isKnockout": true,
      "prompt": "¿Tienes permiso de trabajo en España?",
      "questionSnapshot": { "type": "BOOLEAN", "isKnockout": true, "expectedBoolean": true },
      "answerBoolean": true,
      "answerNumber": null,
      "answerNumberMax": null,
      "answerOptions": [],
      "answerText": null,
      "passed": true,
      "review": "CONFIRMED",
      "origin": "FORM",
      "interviewId": null,
      "resolvedBy": "COMPARISON",
      "aiReading": null,
      "reviewedBy": null,
      "reviewedAt": null,
      "overrideReason": null,
      "answeredAt": "2026-10-02T14:21:07.000Z"
    }
  ],
  "rows": []
}

Errores

  • NOT_FOUND (404): la pregunta no es de esta vacante.
  • INVALID (400): p. ej. un value que no corresponde al tipo de la pregunta.

PATCH /ats/applications/{applicationId}/screening/{answerId}

PATCH/ats/applications/{applicationId}/screening/{answerId}

Revisa una respuesta: la confirma (CONFIRMED) o la levanta con un motivo (DISMISSED), lo que la saca del conteo y la deja registrada. En una respuesta de texto, passed fija el resultado por encima de lo que leyó la IA. Devuelve el screening completo.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
answerIdstring (uuid)SíId de la respuesta de screening.

Body

CampoTipoRequeridoDescripción
reviewCONFIRMED | DISMISSEDSíLa decisión.
overrideReasonstring | nullOpcionalObligatorio con DISMISSED. Hasta 1000 caracteres.
passedbooleanOpcionalSólo con CONFIRMED: pasa o no pasa.
curl -X PATCH "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/screening/0b2d4f6a-8c0e-4b2d-b4f6-8c0e2b4d6f8a" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"review":"DISMISSED","overrideReason":"Confirmó por teléfono que tramita el permiso este mes."}'

Respuesta (extracto)

{
  "verdict": "PASSED",
  "questionCount": 2,
  "answeredCount": 1,
  "failedCount": 0,
  "pendingReviewCount": 0,
  "answers": [
    {
      "id": "0b2d4f6a-8c0e-4b2d-b4f6-8c0e2b4d6f8a",
      "applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
      "screeningQuestionId": "9a1c3e5f-7b9d-4a1c-a3e5-7b9d1a3c5e7f",
      "type": "BOOLEAN",
      "isKnockout": true,
      "prompt": "¿Tienes permiso de trabajo en España?",
      "questionSnapshot": { "type": "BOOLEAN", "isKnockout": true, "expectedBoolean": true },
      "answerBoolean": true,
      "answerNumber": null,
      "answerNumberMax": null,
      "answerOptions": [],
      "answerText": null,
      "passed": true,
      "review": "CONFIRMED",
      "origin": "FORM",
      "interviewId": null,
      "resolvedBy": "COMPARISON",
      "aiReading": null,
      "reviewedBy": null,
      "reviewedAt": null,
      "overrideReason": null,
      "answeredAt": "2026-10-02T14:21:07.000Z"
    }
  ],
  "rows": []
}

Errores

  • INVALID (400): p. ej. DISMISSED sin overrideReason, o passed sin CONFIRMED.
  • NOT_FOUND (404)

Acción equivalente: review_screening_answer.

DELETE /ats/applications/{applicationId}/screening/{answerId}

DELETE/ats/applications/{applicationId}/screening/{answerId}

Una respuesta de screening no se borra con una API key: se levanta con motivo (DISMISSED), que la saca del conteo y la deja registrada.

Una API key no borra este recurso: el DELETE contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "review_screening_answer" }]. Usa en su lugar review_screening_answer.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.
answerIdstring (uuid)SíId de la respuesta de screening.
curl -X DELETE "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/screening/0b2d4f6a-8c0e-4b2d-b4f6-8c0e2b4d6f8a" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (405)

{
  "error": "DELETE_NOT_ALLOWED",
  "allowed": ["PATCH"],
  "suggestions": [{ "tool": "review_screening_answer" }]
}

Entrevistas

Las entrevistas de una postulación, con sus preguntas, respuestas, transcripción y notas. Una entrevista no se borra: se cancela, y lo que se preguntó y anotó queda.

GET /ats/applications/{applicationId}/interviews

GET/ats/applications/{applicationId}/interviews

Lista las entrevistas de la postulación en el orden en que ocurren, sin transcripción ni notas (hasTranscript dice si hay). resolvedCount cuenta las preguntas con una respuesta confirmada o marcadas como no cubiertas.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Pagina: ver Paginación.

curl "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/interviews" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "id": "3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b",
      "name": "Entrevista técnica",
      "type": "TECHNICAL",
      "typeId": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
      "typeName": "Técnica",
      "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
      "interviewerId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
      "interviewerName": "Lucía Gómez",
      "scheduledAt": "2026-10-14T16:00:00.000Z",
      "heldAt": null,
      "meetingUrl": "https://meet.example.com/abc-defg-hij",
      "cancelledAt": null,
      "hasTranscript": false,
      "transcriptPastedAt": null,
      "attendeeIds": ["a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"],
      "questionCount": 6,
      "resolvedCount": 0
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50
}

POST /ats/applications/{applicationId}/interviews

POST/ats/applications/{applicationId}/interviews

Crea una entrevista en la postulación. Devuelve el resumen de la entrevista creada.

Parámetros de ruta

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación.

Body

CampoTipoRequeridoDescripción
namestring | nullOpcionalNombre, hasta 200 caracteres.
typeSCREENING | DEEP_DIVE | TECHNICAL | FINALOpcionalTipo de entrevista de base. Default `SCREENING`.
typeIdstring (uuid) | nullOpcionalUn tipo del catálogo del workspace. Sin él, `type` elige el tipo de base.
stageIdstring (uuid) | nullOpcionalEtapa de la vacante. Sin ella, la etapa actual del candidato.
interviewerIdstring (uuid) | nullOpcionalId de usuario del entrevistador (no el id de membresía).
scheduledAtstring (ISO 8601) | nullOpcionalFecha y hora con zona horaria.
heldAtstring (ISO 8601) | nullOpcionalCuándo se hizo.
meetingUrlstring (URL) | nullOpcionalSólo http o https, hasta 2000 caracteres.
attendeeIdsstring[] (uuid) | nullOpcionalIds de usuario de los asistentes, hasta 20.
curl -X POST "https://app.reclee.com/api/v1/ats/applications/5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e/interviews" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"name":"Entrevista técnica","type":"TECHNICAL","interviewerId":"a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c","scheduledAt":"2026-10-14T16:00:00-03:00","meetingUrl":"https://meet.example.com/abc-defg-hij"}'

Respuesta

{
  "id": "3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b",
  "name": "Entrevista técnica",
  "type": "TECHNICAL",
  "typeId": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
  "typeName": "Técnica",
  "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
  "interviewerId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
  "interviewerName": "Lucía Gómez",
  "scheduledAt": "2026-10-14T16:00:00.000Z",
  "heldAt": null,
  "meetingUrl": "https://meet.example.com/abc-defg-hij",
  "cancelledAt": null,
  "hasTranscript": false,
  "transcriptPastedAt": null,
  "attendeeIds": ["a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"],
  "questionCount": 0,
  "resolvedCount": 0
}

Errores

  • NOT_FOUND (404): la postulación o la etapa no existen.

Acción equivalente: create_interview.

GET /ats/interviews/{interviewId}

GET/ats/interviews/{interviewId}

Devuelve una entrevista completa: el resumen más la transcripción y las notas.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.
curl "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "id": "3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b",
  "name": "Entrevista técnica",
  "type": "TECHNICAL",
  "typeId": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
  "typeName": "Técnica",
  "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
  "interviewerId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
  "interviewerName": "Lucía Gómez",
  "scheduledAt": "2026-10-14T16:00:00.000Z",
  "heldAt": null,
  "meetingUrl": "https://meet.example.com/abc-defg-hij",
  "cancelledAt": null,
  "hasTranscript": true,
  "transcriptPastedAt": "2026-10-14T17:00:00.000Z",
  "attendeeIds": ["a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"],
  "questionCount": 6,
  "resolvedCount": 0,
  "transcript": "Entrevistadora: Cuéntame sobre tu último proyecto…",
  "notes": "Buen nivel técnico."
}

Errores

  • NOT_FOUND (404)

GET /ats/interviews/{interviewId}/detail

GET/ats/interviews/{interviewId}/detail

Una entrevista completa y sus preguntas, en una sola llamada.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.
curl "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/detail" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

{
  "interview": {
    "id": "3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b",
    "name": "Entrevista técnica",
    "hasTranscript": true,
    "questionCount": 6,
    "transcript": "Entrevistadora: Cuéntame sobre tu último proyecto…",
    "notes": "Buen nivel técnico."
  },
  "questions": {
    "ok": true,
    "data": [
      {
        "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
        "position": 0,
        "question": "¿Cómo manejarías la migración de un monolito a servicios?",
        "status": "CONFIRMED",
        "answers": []
      }
    ]
  }
}

interview tiene la forma de GET /ats/interviews/{interviewId}. questions trae su propio resultado: { "ok": true, "data": [...] } con la forma de GET .../questions, o { "ok": false, "error": "<código>" } si no se pudieron leer; ese fallo no oculta la entrevista.

Errores

  • NOT_FOUND (404)

PATCH /ats/interviews/{interviewId}

PATCH/ats/interviews/{interviewId}

Edita una entrevista: cualquiera de sus campos, la transcripción (que se pega por acá), las notas, o la cancela con cancelled: true (false la restaura). Devuelve la entrevista completa.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.

Body

CampoTipoRequeridoDescripción
namestring | nullOpcionalNombre, hasta 200 caracteres.
typeSCREENING | DEEP_DIVE | TECHNICAL | FINALOpcionalTipo de base.
typeIdstring (uuid) | nullOpcionalUn tipo del catálogo del workspace. Sin él, `type` elige el tipo de base.
stageIdstring (uuid) | nullOpcionalEtapa de la vacante. Sin ella, la etapa actual del candidato.
interviewerIdstring (uuid) | nullOpcionalId de usuario del entrevistador (no el id de membresía).
scheduledAtstring (ISO 8601) | nullOpcionalFecha y hora con zona horaria.
heldAtstring (ISO 8601) | nullOpcionalCuándo se hizo.
meetingUrlstring (URL) | nullOpcionalSólo http o https, hasta 2000 caracteres.
attendeeIdsstring[] (uuid) | nullOpcionalIds de usuario de los asistentes, hasta 20.
transcriptstring | nullOpcionalTranscripción, hasta 200 000 caracteres.
notesstring | nullOpcionalNotas, hasta 20 000 caracteres.
cancelledbooleanOpcional`true` la cancela, `false` la restaura.

Todos los campos son opcionales.

curl -X PATCH "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"heldAt":"2026-10-14T16:05:00-03:00","transcript":"Entrevistadora: Cuéntame sobre tu último proyecto…"}'

Respuesta (extracto)

{
  "id": "3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b",
  "name": "Entrevista técnica",
  "type": "TECHNICAL",
  "typeId": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
  "typeName": "Técnica",
  "stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
  "interviewerId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
  "interviewerName": "Lucía Gómez",
  "scheduledAt": "2026-10-14T16:00:00.000Z",
  "heldAt": "2026-10-14T19:05:00.000Z",
  "meetingUrl": "https://meet.example.com/abc-defg-hij",
  "cancelledAt": null,
  "hasTranscript": true,
  "transcriptPastedAt": "2026-10-14T19:40:00.000Z",
  "attendeeIds": ["a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c"],
  "questionCount": 6,
  "resolvedCount": 0,
  "transcript": "Entrevistadora: Cuéntame sobre tu último proyecto…",
  "notes": null
}

Errores

  • NOT_FOUND (404)

Acciones equivalentes: update_interview, set_interview_transcript.

DELETE /ats/interviews/{interviewId}

DELETE/ats/interviews/{interviewId}

Una entrevista no se borra: se cancela con PATCH { "cancelled": true }, y sus preguntas, transcripción y notas quedan.

Una API key no borra este recurso: el DELETE contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_interview" }]. Usa en su lugar update_interview.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.
curl -X DELETE "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (405)

{
  "error": "DELETE_NOT_ALLOWED",
  "allowed": ["GET", "PATCH"],
  "suggestions": [{ "tool": "update_interview" }]
}

POST /ats/interviews/batch/held

POST/ats/interviews/batch/held

Marca varias entrevistas pasadas como realizadas, cada una en el día en que estaba agendada (hoy, si esa fecha no pasó). Una ya realizada, cancelada o de otro workspace se rechaza y queda como estaba.

Body

CampoTipoRequeridoDescripción
interviewIdsstring[] (uuid)SíDe 1 a 200 entrevistas.
curl -X POST "https://app.reclee.com/api/v1/ats/interviews/batch/held" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interviewIds":["3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b","4c6e8a0b-2d4f-4c6e-8a0b-2d4f6c8e0a2b"]}'

Respuesta

{
  "applied": [{ "id": "3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b", "heldAt": "2026-10-14T19:00:00.000Z" }],
  "refused": [{ "id": "4c6e8a0b-2d4f-4c6e-8a0b-2d4f6c8e0a2b", "error": "NOT_FOUND" }]
}

GET /ats/interviews/{interviewId}/question-sources

GET/ats/interviews/{interviewId}/question-sources

Lo que queda abierto para preguntar sobre el candidato, agrupado por fuente y en el orden que pide el tipo de la entrevista. Los items[].id son los que acepta sources en …/questions/generate.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.
curl "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/question-sources" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

[
  {
    "kind": "SOURCING_NO_DATA",
    "count": 1,
    "first": true,
    "items": [
      {
        "id": "7a9c1e3f-5b7d-4a9c-9e3f-5b7d9a1c3e5f",
        "target": "SOURCE_CRITERION",
        "title": "Inglés avanzado"
      }
    ]
  },
  {
    "kind": "PROFILE_AND_JOB_POST",
    "count": 2,
    "first": false,
    "items": [
      { "id": "PROFILE", "target": "PROFILE", "title": "Perfil del candidato" },
      { "id": "JOB_POST", "target": "JOB_POST", "title": "Backend Engineer Sr." }
    ]
  }
]

kind: SCREENING_UNANSWERED, SOURCING_NO_DATA, SOURCING_BAD_FIT, EVALUATION_CRITERIA, EMPTY_CONDITIONS, PROFILE_AND_JOB_POST. first: true marca las fuentes que el tipo de entrevista pregunta primero.

Errores

  • NOT_FOUND (404)

POST /ats/interviews/{interviewId}/answers/generate

POST/ats/interviews/{interviewId}/answers/generate

La IA lee la transcripción y/o las notas y propone una respuesta por pregunta, cada una pendiente de revisión. Las respuestas ya confirmadas no se tocan. Sin body. Devuelve las preguntas de la entrevista. Consume uso.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.
curl -X POST "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/answers/generate" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f"

Respuesta

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
        "review": "NEEDS_REVIEW",
        "notCovered": false,
        "fromTranscript": true,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

Errores

  • NO_TRANSCRIPT_OR_NOTES (400): la entrevista no tiene transcripción ni notas.
  • NO_QUESTIONS (400): no hay preguntas sin respuesta confirmada.
  • NOT_FOUND (404)
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

Acción equivalente: generate_answers_from_transcript.

POST /ats/interviews/{interviewId}/instruction

POST/ats/interviews/{interviewId}/instruction

Aplica una indicación en lenguaje natural sobre las preguntas y respuestas y devuelve el diff, sin aplicarlo. Cada cambio se acepta con PATCH /ats/questions/{questionId} o PATCH /ats/answers/{answerId}. No toca preguntas descartadas. Consume uso.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.

Body

CampoTipoRequeridoDescripción
instructionstringSíUna indicación, de 3 a 1000 caracteres.
questionIdsstring[] (uuid)OpcionalLimita la indicación a estas preguntas (1 a 200). Sin ellas, todo el bloque.
curl -X POST "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/instruction" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"instruction":"Haz las preguntas más cortas."}'

Respuesta

{
  "instruction": "Haz las preguntas más cortas.",
  "changes": [
    {
      "questionId": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
      "answerId": null,
      "label": "Pregunta 1",
      "field": "question",
      "current": "¿Cómo manejarías la migración de un monolito a servicios?",
      "proposed": "¿Cómo migrarías un monolito a servicios?",
      "rationale": "Misma pregunta, más directa."
    }
  ],
  "tokens": 640
}

Errores

  • NOTHING_TO_CHANGE (409): no hay preguntas o respuestas a las que aplicar la indicación.
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

Preguntas de entrevista

Las preguntas de una entrevista y sus respuestas. Una pregunta tiene status (PROPOSED, CONFIRMED, DISMISSED) y puede apuntar a lo que busca resolver (target: un criterio de sourcing o de evaluación, una condición, el perfil o la vacante). Descartar no borra: la pregunta queda y se puede recuperar. Las escrituras devuelven la lista completa de preguntas de la entrevista.

GET /ats/interviews/{interviewId}/questions

GET/ats/interviews/{interviewId}/questions

Lista todas las preguntas de la entrevista, descartadas incluidas, con sus respuestas.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.
curl "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/questions" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
        "review": "NEEDS_REVIEW",
        "notCovered": false,
        "fromTranscript": true,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

En answers, la última es la que vale. review es NEEDS_REVIEW, CONFIRMED o DISMISSED; notCovered: true dice que la transcripción no cubrió la pregunta; fromTranscript y edited dicen si la escribió la IA y si una persona la reescribió.

Errores

  • NOT_FOUND (404)

POST /ats/interviews/{interviewId}/questions

POST/ats/interviews/{interviewId}/questions

Agrega una pregunta escrita a mano.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.

Body

CampoTipoRequeridoDescripción
questionstringSíDe 1 a 2000 caracteres.
targetenum | nullOpcionalQué busca resolver: SOURCE_CRITERION, EVALUATION_CRITERION, CONDITION, PROFILE, JOB_POST.
targetIdstring (uuid) | nullOpcionalObligatorio con SOURCE_CRITERION, EVALUATION_CRITERION o CONDITION; no se admite con PROFILE ni JOB_POST.
suggestedbooleanOpcional`true` la deja como sugerencia hasta que alguien la acepte.
curl -X POST "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/questions" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"question":"¿Qué nivel de inglés usas a diario?","target":"SOURCE_CRITERION","targetId":"7a9c1e3f-5b7d-4a9c-9e3f-5b7d9a1c3e5f"}'

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
        "review": "NEEDS_REVIEW",
        "notCovered": false,
        "fromTranscript": true,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

Errores

  • INVALID (400): p. ej. target sin el targetId que pide.
  • NOT_FOUND (404)

POST /ats/interviews/{interviewId}/questions/generate

POST/ats/interviews/{interviewId}/questions/generate

La IA genera preguntas a partir de lo que sigue abierto sobre el candidato y las agrega como PROPOSED; nunca toca las que ya están. El body es opcional: sin él usa todas las fuentes. Consume uso.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.

Body

CampoTipoRequeridoDescripción
targetsstring[]OpcionalLimita a estos destinos: SOURCE_CRITERION, EVALUATION_CRITERION, CONDITION, PROFILE, JOB_POST.
kindsstring[]OpcionalLimita a estas fuentes: SCREENING_UNANSWERED, SOURCING_NO_DATA, SOURCING_BAD_FIT, EVALUATION_CRITERIA, EMPTY_CONDITIONS, PROFILE_AND_JOB_POST.
sourcesstring[]OpcionalFuentes puntuales (1 a 20), por los ids de `…/question-sources`: una pregunta por cada una.
countinteger (1–20)OpcionalCuántas preguntas pedir.
curl -X POST "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/questions/generate" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"kinds":["SOURCING_NO_DATA","EMPTY_CONDITIONS"],"count":5}'

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "PROPOSED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": []
  }
]

Errores

  • NOTHING_TO_ASK (409): no queda nada abierto que preguntar con esas fuentes.
  • NOT_FOUND (404)
  • USAGE_WINDOW, USAGE_EXHAUSTED, TEAM_WINDOW, TEAM_USAGE_EXHAUSTED (402): se agotó el uso de IA del plan o del equipo. Ver Créditos y uso.

Acción equivalente: generate_interview_questions.

PUT /ats/interviews/{interviewId}/questions/reorder

PUT/ats/interviews/{interviewId}/questions/reorder

Reordena las preguntas. Recibe la lista completa de ids en el orden nuevo.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.

Body

CampoTipoRequeridoDescripción
idsstring[] (uuid)SíTodos los ids de preguntas de la entrevista, en orden.
curl -X PUT "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/questions/reorder" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a","5d7f9b1c-3e5a-4d7f-9b1c-3e5a7d9f1b3c"]}'

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
        "review": "NEEDS_REVIEW",
        "notCovered": false,
        "fromTranscript": true,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

Errores

  • INCOMPLETE (400): la lista no trae todas las preguntas.
  • NOT_FOUND (404)

PATCH /ats/interviews/{interviewId}/questions/status

PATCH/ats/interviews/{interviewId}/questions/status

Pone el mismo estado a varias preguntas de la entrevista («confirmar todas», «descartar todas»). Sólo cambia el estado. Devuelve qué preguntas cambiaron, cuáles se rechazaron y la lista actualizada.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.

Body

CampoTipoRequeridoDescripción
questionIdsstring[] (uuid)SíDe 1 a 200 preguntas de esta entrevista.
statusPROPOSED | CONFIRMED | DISMISSEDSíEstado nuevo.
curl -X PATCH "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/questions/status" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"questionIds":["4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a"],"status":"CONFIRMED"}'

Respuesta (extracto)

{
  "applied": ["4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a"],
  "refused": [],
  "questions": [
    {
      "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
      "position": 0,
      "question": "¿Cómo manejarías la migración de un monolito a servicios?",
      "source": "AI_GENERATED",
      "status": "CONFIRMED",
      "target": "EVALUATION_CRITERION",
      "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
      "targetLabel": "Diseño de APIs",
      "answers": [
        {
          "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
          "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
          "review": "NEEDS_REVIEW",
          "notCovered": false,
          "fromTranscript": true,
          "edited": false,
          "createdAt": "2026-10-14T17:05:12.000Z"
        }
      ]
    }
  ]
}

POST /ats/interviews/{interviewId}/questions/suggestions

POST/ats/interviews/{interviewId}/questions/suggestions

Agrega una pregunta como sugerencia, apuntada al criterio de sourcing que persigue (o a ninguno). Es la que manda la pestaña de compatibilidad; espera hasta que alguien la acepte.

Parámetros de ruta

CampoTipoRequeridoDescripción
interviewIdstring (uuid)SíId de la entrevista.

Body

CampoTipoRequeridoDescripción
questionstringSíDe 1 a 2000 caracteres.
criterionIdstring (uuid) | nullSíCriterio de sourcing, o `null`. La clave tiene que estar.
curl -X POST "https://app.reclee.com/api/v1/ats/interviews/3a5c7e9b-1d3f-4a5c-9e7b-1d3f5a7c9e1b/questions/suggestions" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"question":"¿En qué idioma trabajaba tu equipo?","criterionId":"7a9c1e3f-5b7d-4a9c-9e3f-5b7d9a1c3e5f"}'

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
        "review": "NEEDS_REVIEW",
        "notCovered": false,
        "fromTranscript": true,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

Errores

  • NOT_FOUND (404)

PATCH /ats/questions/{questionId}

PATCH/ats/questions/{questionId}

Edita el texto de una pregunta o la mueve entre confirmada y descartada.

Parámetros de ruta

CampoTipoRequeridoDescripción
questionIdstring (uuid)SíId de la pregunta de entrevista.

Body

CampoTipoRequeridoDescripción
questionstringOpcionalTexto nuevo, de 1 a 2000 caracteres.
statusPROPOSED | CONFIRMED | DISMISSEDOpcional`DISMISSED` la aparta; `CONFIRMED` la acepta o la recupera.
curl -X PATCH "https://app.reclee.com/api/v1/ats/questions/4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"DISMISSED"}'

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "DISMISSED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
        "review": "NEEDS_REVIEW",
        "notCovered": false,
        "fromTranscript": true,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

Errores

  • NOT_FOUND (404)

Acción equivalente: update_interview_question.

DELETE /ats/questions/{questionId}

DELETE/ats/questions/{questionId}

Una pregunta no se borra (alguien puede haberla contestado): se descarta con PATCH { "status": "DISMISSED" }.

Una API key no borra este recurso: el DELETE contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_interview_question" }]. Usa en su lugar update_interview_question.

Parámetros de ruta

CampoTipoRequeridoDescripción
questionIdstring (uuid)SíId de la pregunta de entrevista.
curl -X DELETE "https://app.reclee.com/api/v1/ats/questions/4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (405)

{
  "error": "DELETE_NOT_ALLOWED",
  "allowed": ["PATCH"],
  "suggestions": [{ "tool": "update_interview_question" }]
}

PUT /ats/questions/{questionId}/answer

PUT/ats/questions/{questionId}/answer

Contesta una pregunta a mano, haya transcripción o no. Si la pregunta apunta a una condición, la IA puede dejar el valor que leyó como propuesta en la condición (es un intento: si no lo logra, la respuesta se guarda igual).

Parámetros de ruta

CampoTipoRequeridoDescripción
questionIdstring (uuid)SíId de la pregunta de entrevista.

Body

CampoTipoRequeridoDescripción
contentstringSíRespuesta, de 1 a 8000 caracteres.
curl -X PUT "https://app.reclee.com/api/v1/ats/questions/4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a/answer" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Separaría primero los módulos con menos dependencias y los expondría detrás de una API."}'

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias y los expondría detrás de una API.</p>",
        "review": "CONFIRMED",
        "notCovered": false,
        "fromTranscript": false,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

Errores

  • NOT_FOUND (404)

DELETE /ats/questions/{questionId}/answer

DELETE/ats/questions/{questionId}/answer

Quita la respuesta: la pregunta queda sin contestar. Es un DELETE que una API key sí puede usar. Devuelve la lista de preguntas.

Parámetros de ruta

CampoTipoRequeridoDescripción
questionIdstring (uuid)SíId de la pregunta de entrevista.
curl -X DELETE "https://app.reclee.com/api/v1/ats/questions/4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a/answer" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": []
  }
]

Errores

  • NOT_FOUND (404)

PATCH /ats/answers/{answerId}

PATCH/ats/answers/{answerId}

Revisa una respuesta propuesta por la IA: la confirma, la edita (editar el texto también la confirma) o la descarta.

Parámetros de ruta

CampoTipoRequeridoDescripción
answerIdstring (uuid)SíId de la respuesta.

Body

CampoTipoRequeridoDescripción
contentstringOpcionalTexto corregido, de 1 a 8000 caracteres.
reviewNEEDS_REVIEW | CONFIRMED | DISMISSEDOpcionalEstado de revisión nuevo.
curl -X PATCH "https://app.reclee.com/api/v1/ats/answers/5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"review":"CONFIRMED"}'

Respuesta (extracto)

[
  {
    "id": "4b6d8f0a-2c4e-4b6d-8f0a-2c4e6b8d0f2a",
    "position": 0,
    "question": "¿Cómo manejarías la migración de un monolito a servicios?",
    "source": "AI_GENERATED",
    "status": "CONFIRMED",
    "target": "EVALUATION_CRITERION",
    "targetId": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
    "targetLabel": "Diseño de APIs",
    "answers": [
      {
        "id": "5c7e9a1b-3d5f-4c7e-9a1b-3d5f7c9e1a3b",
        "content": "<p>Separaría primero los módulos con menos dependencias…</p>",
        "review": "CONFIRMED",
        "notCovered": false,
        "fromTranscript": true,
        "edited": false,
        "createdAt": "2026-10-14T17:05:12.000Z"
      }
    ]
  }
]

Errores

  • NOT_FOUND (404)

Tipos de entrevista

El catálogo de tipos de entrevista del workspace: qué tiene que averiguar la IA al generar preguntas (instruction) y por qué fuentes empieza (firstSources). Trae cuatro tipos de base (systemKey); el de screening no se renombra ni se archiva. Crear, editar y archivar tipos es sólo para el rol OWNER.

GET /ats/interview-types

GET/ats/interview-types

Lista el catálogo: primero los cuatro de base, los archivados al final.

Pagina: ver Paginación.

curl "https://app.reclee.com/api/v1/ats/interview-types" \
  -H "Authorization: Bearer $RECLEE_API_KEY"

Respuesta

{
  "rows": [
    {
      "id": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
      "name": "Técnica",
      "instruction": "Profundiza en arquitectura y decisiones técnicas recientes.",
      "firstSources": ["EVALUATION_CRITERIA", "SOURCING_NO_DATA"],
      "systemKey": "TECHNICAL",
      "isSystem": false,
      "archivedAt": null
    }
  ],
  "total": 5,
  "page": 1,
  "pageSize": 50
}

POST /ats/interview-types

POST/ats/interview-types

Crea un tipo de entrevista. Sólo OWNER.

Body

CampoTipoRequeridoDescripción
namestringSíDe 1 a 80 caracteres, único en el workspace.
instructionstringSíQué tiene que averiguar, de 1 a 1000 caracteres.
firstSourcesstring[]SíFuentes que se preguntan primero, en orden (puede ser `[]`): SCREENING_UNANSWERED, SOURCING_NO_DATA, SOURCING_BAD_FIT, EVALUATION_CRITERIA, EMPTY_CONDITIONS, PROFILE_AND_JOB_POST.
curl -X POST "https://app.reclee.com/api/v1/ats/interview-types" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{"name":"Cultural","instruction":"Indaga cómo trabaja en equipo y cómo maneja desacuerdos.","firstSources":["PROFILE_AND_JOB_POST"]}'

Respuesta

{
  "id": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
  "name": "Cultural",
  "instruction": "Indaga cómo trabaja en equipo y cómo maneja desacuerdos.",
  "firstSources": ["PROFILE_AND_JOB_POST"],
  "systemKey": null,
  "isSystem": false,
  "archivedAt": null
}

Errores

  • NAME_TAKEN (409): ya hay un tipo con ese nombre.
  • FORBIDDEN (403): sólo un OWNER.

PATCH /ats/interview-types/{typeId}

PATCH/ats/interview-types/{typeId}

Edita un tipo. Cambia lo que se genere de ahora en más, nunca lo ya generado. Sólo OWNER.

Parámetros de ruta

CampoTipoRequeridoDescripción
typeIdstring (uuid)SíId del tipo de entrevista.

Body

CampoTipoRequeridoDescripción
namestringOpcionalDe 1 a 80 caracteres.
instructionstringOpcionalDe 1 a 1000 caracteres.
firstSourcesstring[]OpcionalFuentes que se preguntan primero.

Hace falta al menos un campo.

curl -X PATCH "https://app.reclee.com/api/v1/ats/interview-types/b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instruction":"Profundiza en arquitectura, decisiones técnicas recientes y code review."}'

Respuesta

{
  "id": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
  "name": "Técnica",
  "instruction": "Profundiza en arquitectura, decisiones técnicas recientes y code review.",
  "firstSources": ["EVALUATION_CRITERIA", "SOURCING_NO_DATA"],
  "systemKey": "TECHNICAL",
  "isSystem": false,
  "archivedAt": null
}

Errores

  • SYSTEM_TYPE (409): el tipo de screening no se renombra.
  • NAME_TAKEN (409)
  • FORBIDDEN (403): sólo un OWNER.
  • NOT_FOUND (404)

PUT /ats/interview-types/{typeId}/archived

PUT/ats/interview-types/{typeId}/archived

Archiva un tipo (deja de ofrecerse; las entrevistas que lo usan lo conservan) o lo restaura. Sólo OWNER.

Parámetros de ruta

CampoTipoRequeridoDescripción
typeIdstring (uuid)SíId del tipo de entrevista.

Body

CampoTipoRequeridoDescripción
archivedbooleanSí`true` archiva, `false` restaura.
curl -X PUT "https://app.reclee.com/api/v1/ats/interview-types/b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d/archived" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"archived":true}'

Respuesta

{
  "id": "b2d4f6a8-0c2e-4d4f-96a8-0c2e4f6a8b0d",
  "name": "Técnica",
  "instruction": "Profundiza en arquitectura y decisiones técnicas recientes.",
  "firstSources": ["EVALUATION_CRITERIA", "SOURCING_NO_DATA"],
  "systemKey": "TECHNICAL",
  "isSystem": false,
  "archivedAt": "2026-10-20T11:00:00.000Z"
}

Errores

  • SYSTEM_TYPE (409): el tipo de screening no se archiva.
  • FORBIDDEN (403): sólo un OWNER.
  • NOT_FOUND (404)

En esta página

PostulacionesGET /ats/applications/{applicationId}/contextGET /ats/applications/{applicationId}/cover-letterGET /ats/applications/{applicationId}/timelineGET /ats/applications/{applicationId}/stages/{stageId}/feedbackPUT /ats/applications/{applicationId}/stagePUT /ats/applications/{applicationId}/statusPOST /ats/applications/{applicationId}/hirePOST /ats/applications/{applicationId}/guaranteePOST /ats/applications/matchOperaciones en lotePUT /ats/applications/batch/stagePUT /ats/applications/batch/statusPATCH /ats/applications/batch/labelsComentariosGET /ats/applications/{applicationId}/commentsPOST /ats/applications/{applicationId}/commentsPATCH /ats/comments/{commentId}DELETE /ats/comments/{commentId}EtiquetasGET /ats/applications/{applicationId}/labelsPOST /ats/applications/{applicationId}/labelsDELETE /ats/applications/{applicationId}/labels/{labelId}GET /ats/labelsPOST /ats/labelsPATCH /ats/labels/{labelId}DELETE /ats/labels/{labelId}Compatibilidad y match scoreGET /ats/applications/{applicationId}/compatibilityGET /ats/applications/{applicationId}/match-scorePOST /ats/applications/{applicationId}/summaryCondicionesGET /ats/applications/{applicationId}/conditionsPUT /ats/applications/{applicationId}/conditionsPUT /ats/applications/{applicationId}/conditions/proposalConsideracionesGET /ats/applications/{applicationId}/considerationsPOST /ats/applications/{applicationId}/considerationsPUT /ats/applications/{applicationId}/considerations/reorderPATCH /ats/considerations/{considerationId}ScorecardGET /ats/applications/{applicationId}/scorecardGET /ats/applications/{applicationId}/evaluationPUT /ats/applications/{applicationId}/scorecardPUT /ats/applications/{applicationId}/scorecard/evaluatorPOST /ats/applications/{applicationId}/scorecard/draftPOST /ats/applications/{applicationId}/scorecard/instructionPOST /ats/applications/{applicationId}/scorecard/proposalsPATCH /ats/applications/{applicationId}/scorecard/proposalsPOST /ats/applications/{applicationId}/scorecard/proposals/allPUT /ats/applications/{applicationId}/scorecard/rationalePOST /ats/applications/{applicationId}/scorecard/rationale/proposalInformeGET /ats/applications/{applicationId}/reportPOST /ats/applications/{applicationId}/reportGET /ats/applications/{applicationId}/report/readinessPOST /ats/applications/{applicationId}/report/draftPATCH /ats/applications/{applicationId}/report/blocksPOST /ats/applications/{applicationId}/report/blocksPOST /ats/applications/{applicationId}/report/proposalsPOST /ats/applications/{applicationId}/report/requirementsPATCH /ats/applications/{applicationId}/report/requirementsPOST /ats/applications/{applicationId}/report/requirements/allGET /ats/applications/{applicationId}/report/versionsGET /ats/applications/{applicationId}/report/versions/{version}POST /ats/applications/{applicationId}/report/translationGET /ats/applications/{applicationId}/report/download-sourcesPOST /ats/applications/{applicationId}/report/downloadsScreeningGET /ats/applications/{applicationId}/screeningPUT /ats/applications/{applicationId}/screeningPATCH /ats/applications/{applicationId}/screening/{answerId}DELETE /ats/applications/{applicationId}/screening/{answerId}EntrevistasGET /ats/applications/{applicationId}/interviewsPOST /ats/applications/{applicationId}/interviewsGET /ats/interviews/{interviewId}GET /ats/interviews/{interviewId}/detailPATCH /ats/interviews/{interviewId}DELETE /ats/interviews/{interviewId}POST /ats/interviews/batch/heldGET /ats/interviews/{interviewId}/question-sourcesPOST /ats/interviews/{interviewId}/answers/generatePOST /ats/interviews/{interviewId}/instructionPreguntas de entrevistaGET /ats/interviews/{interviewId}/questionsPOST /ats/interviews/{interviewId}/questionsPOST /ats/interviews/{interviewId}/questions/generatePUT /ats/interviews/{interviewId}/questions/reorderPATCH /ats/interviews/{interviewId}/questions/statusPOST /ats/interviews/{interviewId}/questions/suggestionsPATCH /ats/questions/{questionId}DELETE /ats/questions/{questionId}PUT /ats/questions/{questionId}/answerDELETE /ats/questions/{questionId}/answerPATCH /ats/answers/{answerId}Tipos de entrevistaGET /ats/interview-typesPOST /ats/interview-typesPATCH /ats/interview-types/{typeId}PUT /ats/interview-types/{typeId}/archived