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
/ats/applications/{applicationId}/contextDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/cover-letterDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/timelineDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/stages/{stageId}/feedbackCuenta 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
| stageId | string (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
/ats/applications/{applicationId}/stageMueve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| stageId | string (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;missingdice 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
/ats/applications/{applicationId}/statusCambia 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| status | DISQUALIFIED | QUALIFIED | WITHDRAWN | Sí | Estado nuevo. QUALIFIED vuelve a poner en carrera a alguien descartado o retirado. |
| reason | enum | Opcional | Obligatorio con DISQUALIFIED. Uno de: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, OTHER. |
| comment | string | Opcional | Hasta 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 exigereason.COMMENT_REQUIRED(400): volver a calificar un descarte exigecomment.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
/ats/applications/{applicationId}/hireContrata 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| salary | number | Sí | Salario acordado, mayor que 0. |
| startDate | string (YYYY-MM-DD) | Sí | Fecha de ingreso. |
| currencyCode | string (ISO 4217) | Opcional | Moneda, p. ej. USD o EUR. Si falta, la de la vacante. |
| salaryPeriod | HOURLY | DAILY | MONTHLY | YEARLY | Opcional | Período del salario. Si falta, el de la vacante. |
| feePct | number (0–100) | Opcional | Fee en porcentaje. Si falta, el del cliente. |
| guaranteeDays | integer (1–365) | Opcional | Dí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 conPUT …/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;missingdice 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
/ats/applications/{applicationId}/guaranteeRegistra 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leftAt | string (YYYY-MM-DD) | Sí | Fecha en que la persona se fue. |
| reason | RESIGNED | DISMISSED | OTHER | Sí | Motivo de la salida. |
| note | string | Opcional | Nota, 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):leftAtes anterior a la fecha de ingreso.
Acción equivalente: activate_guarantee.
POST /ats/applications/match
/ats/applications/matchFiltra 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationIds | string[] (uuid) | Sí | Las postulaciones a filtrar, hasta 5000. La respuesta nunca sale de este conjunto. |
| filters | object | Sí | Los filtros. Sin ninguno, devuelve los mismos ids. |
| filters.interviewerIds | string[] (uuid) | Opcional | Ids de usuario de entrevistadores, hasta 100. |
| filters.screeningAnswers | object[] | Opcional | Hasta 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
/ats/applications/batch/stageMueve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| moves | object[] | 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
/ats/applications/batch/statusCambia el estado de varias postulaciones con las mismas reglas que PUT …/status, fila por fila.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationIds | string[] (uuid) | Sí | De 1 a 200 postulaciones. |
| jobPostId | string (uuid) | Opcional | Si lo mandas, una postulación de otra vacante se rechaza en vez de cambiarse. |
| status | DISQUALIFIED | QUALIFIED | WITHDRAWN | Sí | Estado nuevo. QUALIFIED vuelve a poner en carrera a alguien descartado o retirado. |
| reason | enum | Opcional | Obligatorio con DISQUALIFIED. Uno de: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, OTHER. |
| comment | string | Opcional | Hasta 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
/ats/applications/batch/labelsPone 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationIds | string[] (uuid) | Sí | De 1 a 200 postulaciones. |
| jobPostId | string (uuid) | Opcional | Si lo mandas, una postulación de otra vacante se rechaza. |
| add | object[] | Opcional | Hasta 20 `{ name, color }` a poner. `name` de 1 a 60 caracteres; `color` opcional. Default `[]`. |
| remove | string[] (uuid) | Opcional | Hasta 20 ids de etiqueta a sacar. Default `[]`. |
| createIfMissing | boolean | Opcional | Crea 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): concreateIfMissing: 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
/ats/applications/{applicationId}/commentsLista los comentarios de la postulación, raíces y respuestas, del más viejo al más nuevo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/commentsAgrega 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| body | string | Sí | Texto, de 1 a 5000 caracteres. |
| parentId | string (uuid) | null | Opcional | Comentario raíz al que responde. Sin él, es un comentario raíz. |
| sentiment | GOOD | NEUTRAL | BAD | null | Opcional | Valoración. No se admite en una respuesta. |
| stageId | string (uuid) | null | Opcional | Etapa 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 consentiment, o unparentIdque 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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| commentId | string (uuid) | Sí | Id del comentario. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| body | string | Sí | Texto nuevo, de 1 a 5000 caracteres. |
| sentiment | GOOD | NEUTRAL | BAD | null | Opcional | `null` la borra; si falta, queda como estaba. |
| stageId | string (uuid) | null | Opcional | Etapa 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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| commentId | string (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
/ats/applications/{applicationId}/labelsLista las etiquetas que tiene la postulación.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/labelsPone 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre, de 1 a 60 caracteres. Se compara sin distinguir mayúsculas. |
| color | string | null | Opcional | Color, sólo si la etiqueta se crea: blue, teal, green, amber, orange, rose, purple o slate. |
| createIfMissing | boolean | Opcional | Default `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): concreateIfMissing: false, el nombre no existe.NOT_FOUND(404)
Acción equivalente: add_application_label.
DELETE /ats/applications/{applicationId}/labels/{labelId}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
| labelId | string (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
/ats/labelsLista 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
/ats/labelsCrea una etiqueta en el workspace, sin ponérsela a nadie.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre, de 1 a 60 caracteres, único en el workspace. |
| color | string | null | Opcional | blue, 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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| labelId | string (uuid) | Sí | Id de la etiqueta. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Opcional | Nombre nuevo, de 1 a 60 caracteres. |
| color | string | null | Opcional | Color nuevo. |
| archived | true | Opcional | Só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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| labelId | string (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
/ats/applications/{applicationId}/compatibilityDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/match-scoreAntes 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/summaryDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/conditionsDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/conditionsEscribe 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| conditionId | string (uuid) | Sí | Condición de la vacante de esta postulación. |
| value | string | null | Opcional | Texto 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
/ats/applications/{applicationId}/conditions/proposalAcepta 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| conditionId | string (uuid) | Sí | La condición. |
| accept | boolean | Sí | `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
/ats/applications/{applicationId}/considerationsLista las consideraciones de la postulación, en el orden en que se leen en el informe.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/considerationsEscribe una consideración nueva. Todas se publican al cliente cuando se confirman: no hay consideraciones internas.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| kind | enum | Sí | REQUIREMENT_EXCEPTION, GAP, RISK, DATA_RELIABILITY, COMPENSATION o HIGHLIGHT. |
| title | string | Sí | Título, de 1 a 200 caracteres. |
| body | string | Sí | 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
/ats/applications/{applicationId}/considerations/reorderReordena 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| ids | string[] (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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| considerationId | string (uuid) | Sí | Id de la consideración. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| kind | enum | Opcional | Tipo nuevo. |
| title | string | Opcional | De 1 a 200 caracteres. |
| body | string | Opcional | HTML, de 1 a 8000 caracteres. |
| status | PROPOSED | CONFIRMED | DISMISSED | Opcional | Estado 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
/ats/applications/{applicationId}/scorecardDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/evaluationLo que muestra la pestaña Evaluación del candidato, en una sola llamada: el scorecard y las consideraciones.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/scorecardPuntúa o comenta un criterio, uno por llamada. Devuelve el scorecard completo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| criterionId | string (uuid) | Sí | Criterio de evaluación de la vacante. |
| score | integer (1–5) | null | Opcional | Puntaje; `null` lo deja pendiente. |
| comment | string | null | Opcional | HTML, 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
/ats/applications/{applicationId}/scorecard/evaluatorAsigna el evaluador de la postulación, o la deja sin evaluador con null. Devuelve el scorecard.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| evaluatorId | string (uuid) | null | Sí | 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
/ats/applications/{applicationId}/scorecard/draftLa 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/scorecard/instructionAplica 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| instruction | string | Sí | 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
/ats/applications/{applicationId}/scorecard/proposalsAdopta 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| criterionId | string (uuid) | Sí | La fila. |
| score | integer (1–5) | Opcional | Puntaje distinto al propuesto. |
| comment | string | null | Opcional | Comentario 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
/ats/applications/{applicationId}/scorecard/proposalsDescarta la propuesta de una fila (DISMISSED) o la recupera (PROPOSED). Devuelve el scorecard.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| criterionId | string (uuid) | Sí | La fila. |
| state | PROPOSED | DISMISSED | Sí | 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
/ats/applications/{applicationId}/scorecard/proposals/allAdopta tal cual todas las propuestas pendientes que traen puntaje. Sólo el evaluador. Sin body.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/scorecard/rationaleGuarda 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| rationale | string | Sí | 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
/ats/applications/{applicationId}/scorecard/rationale/proposalAdopta o descarta el texto de recomendación que propuso la IA.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| accept | boolean | Sí | `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
/ats/applications/{applicationId}/reportDevuelve la última versión del informe, con su contenido, o null si nunca se armó.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/reportArma 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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/readinessdice qué.NOT_FOUND(404)
Acción equivalente: generate_report.
GET /ats/applications/{applicationId}/report/readiness
/ats/applications/{applicationId}/report/readinessDice 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/report/draftLa 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| block | enum | Opcional | recommendation, 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
/ats/applications/{applicationId}/report/blocksCorrige 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| block | enum | Sí | recommendation, profile, evaluation, considerations, conditions o requirements. Define qué otros campos van. |
| row | integer ≥ 0 | Opcional | Posición de la fila en la versión vigente. Obligatorio en evaluation, considerations, conditions y requirements. |
| text | string | Opcional | recommendation: el texto (HTML, hasta 8000). |
| summary | string | Opcional | profile: el perfil narrativo. |
| comment | string | Opcional | evaluation: el comentario de la fila. |
| title / body | string | Opcional | considerations: `title` opcional (1–200) y `body`. |
| value | string | Opcional | conditions: el valor. |
| outcome / rationale | PASS | FAIL, string | Opcional | requirements: `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
/ats/applications/{applicationId}/report/blocksPone 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| block | enum | Sí | 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
/ats/applications/{applicationId}/report/proposalsAdopta (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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| block | enum | Sí | recommendation, evaluation, profile, considerations o conditions. |
| row | integer ≥ 0 | Opcional | Obligatorio en evaluation, considerations y conditions; no se admite en los demás. |
| accept | boolean | Sí | `true` adopta, `false` descarta. |
| text | string | Opcional | Versió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
/ats/applications/{applicationId}/report/requirementsConfirma 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| criterionId | string (uuid) | Sí | Criterio de sourcing del requisito. |
| outcome | PASS | FAIL | Opcional | Resultado distinto al propuesto. |
| rationale | string | Opcional | Fundamento 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
/ats/applications/{applicationId}/report/requirementsDescarta un requisito que propuso la IA. Una fila ya confirmada para ese criterio queda como estaba.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| criterionId | string (uuid) | Sí | Criterio del requisito. |
| state | DISMISSED | Sí | 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
/ats/applications/{applicationId}/report/requirements/allConfirma 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/report/versionsLista 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
| version | integer ≥ 1 | Sí | 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):versionno es un entero mayor o igual a 1.
POST /ats/applications/{applicationId}/report/translation
/ats/applications/{applicationId}/report/translationDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| version | integer ≥ 1 | Sí | Versión a traducir. |
| locale | enum | Sí | 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
/ats/applications/{applicationId}/report/download-sourcesApoyo 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/report/downloadsRegistra 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| version | integer ≥ 1 | Sí | Versión descargada. |
| locale | enum | Sí | Idioma: es, en, pt, fr, de, it. |
| profileSource | WORKSPACE | CV | LINKEDIN | null | Sí | De qué perfil salió la sección de perfil completo, o `null` sin ella. |
| contact | boolean | Sí | 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
trueErrores
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
/ats/applications/{applicationId}/screeningDevuelve 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/screeningAnota 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| questionId | string (uuid) | Sí | Pregunta de screening de la vacante. |
| origin | MANUAL | INTERVIEW | Sí | De dónde sale la respuesta. |
| interviewId | string (uuid) | null | Opcional | Obligatorio con INTERVIEW, y sólo con INTERVIEW. |
| value | object | Sí | 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. unvalueque no corresponde al tipo de la pregunta.
PATCH /ats/applications/{applicationId}/screening/{answerId}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
| answerId | string (uuid) | Sí | Id de la respuesta de screening. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| review | CONFIRMED | DISMISSED | Sí | La decisión. |
| overrideReason | string | null | Opcional | Obligatorio con DISMISSED. Hasta 1000 caracteres. |
| passed | boolean | Opcional | Só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 sinoverrideReason, opassedsin CONFIRMED.NOT_FOUND(404)
Acción equivalente: review_screening_answer.
DELETE /ats/applications/{applicationId}/screening/{answerId}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
| answerId | string (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
/ats/applications/{applicationId}/interviewsLista 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (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
/ats/applications/{applicationId}/interviewsCrea una entrevista en la postulación. Devuelve el resumen de la entrevista creada.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | null | Opcional | Nombre, hasta 200 caracteres. |
| type | SCREENING | DEEP_DIVE | TECHNICAL | FINAL | Opcional | Tipo de entrevista de base. Default `SCREENING`. |
| typeId | string (uuid) | null | Opcional | Un tipo del catálogo del workspace. Sin él, `type` elige el tipo de base. |
| stageId | string (uuid) | null | Opcional | Etapa de la vacante. Sin ella, la etapa actual del candidato. |
| interviewerId | string (uuid) | null | Opcional | Id de usuario del entrevistador (no el id de membresía). |
| scheduledAt | string (ISO 8601) | null | Opcional | Fecha y hora con zona horaria. |
| heldAt | string (ISO 8601) | null | Opcional | Cuándo se hizo. |
| meetingUrl | string (URL) | null | Opcional | Sólo http o https, hasta 2000 caracteres. |
| attendeeIds | string[] (uuid) | null | Opcional | Ids 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}
/ats/interviews/{interviewId}Devuelve una entrevista completa: el resumen más la transcripción y las notas.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (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
/ats/interviews/{interviewId}/detailUna entrevista completa y sus preguntas, en una sola llamada.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (uuid) | Sí | Id de la entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | null | Opcional | Nombre, hasta 200 caracteres. |
| type | SCREENING | DEEP_DIVE | TECHNICAL | FINAL | Opcional | Tipo de base. |
| typeId | string (uuid) | null | Opcional | Un tipo del catálogo del workspace. Sin él, `type` elige el tipo de base. |
| stageId | string (uuid) | null | Opcional | Etapa de la vacante. Sin ella, la etapa actual del candidato. |
| interviewerId | string (uuid) | null | Opcional | Id de usuario del entrevistador (no el id de membresía). |
| scheduledAt | string (ISO 8601) | null | Opcional | Fecha y hora con zona horaria. |
| heldAt | string (ISO 8601) | null | Opcional | Cuándo se hizo. |
| meetingUrl | string (URL) | null | Opcional | Sólo http o https, hasta 2000 caracteres. |
| attendeeIds | string[] (uuid) | null | Opcional | Ids de usuario de los asistentes, hasta 20. |
| transcript | string | null | Opcional | Transcripción, hasta 200 000 caracteres. |
| notes | string | null | Opcional | Notas, hasta 20 000 caracteres. |
| cancelled | boolean | Opcional | `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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (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
/ats/interviews/batch/heldMarca 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewIds | string[] (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
/ats/interviews/{interviewId}/question-sourcesLo 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (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
/ats/interviews/{interviewId}/answers/generateLa 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (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
/ats/interviews/{interviewId}/instructionAplica 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (uuid) | Sí | Id de la entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| instruction | string | Sí | Una indicación, de 3 a 1000 caracteres. |
| questionIds | string[] (uuid) | Opcional | Limita 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
/ats/interviews/{interviewId}/questionsLista todas las preguntas de la entrevista, descartadas incluidas, con sus respuestas.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (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
/ats/interviews/{interviewId}/questionsAgrega una pregunta escrita a mano.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (uuid) | Sí | Id de la entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| question | string | Sí | De 1 a 2000 caracteres. |
| target | enum | null | Opcional | Qué busca resolver: SOURCE_CRITERION, EVALUATION_CRITERION, CONDITION, PROFILE, JOB_POST. |
| targetId | string (uuid) | null | Opcional | Obligatorio con SOURCE_CRITERION, EVALUATION_CRITERION o CONDITION; no se admite con PROFILE ni JOB_POST. |
| suggested | boolean | Opcional | `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.targetsin eltargetIdque pide.NOT_FOUND(404)
POST /ats/interviews/{interviewId}/questions/generate
/ats/interviews/{interviewId}/questions/generateLa 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (uuid) | Sí | Id de la entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| targets | string[] | Opcional | Limita a estos destinos: SOURCE_CRITERION, EVALUATION_CRITERION, CONDITION, PROFILE, JOB_POST. |
| kinds | string[] | Opcional | Limita a estas fuentes: SCREENING_UNANSWERED, SOURCING_NO_DATA, SOURCING_BAD_FIT, EVALUATION_CRITERIA, EMPTY_CONDITIONS, PROFILE_AND_JOB_POST. |
| sources | string[] | Opcional | Fuentes puntuales (1 a 20), por los ids de `…/question-sources`: una pregunta por cada una. |
| count | integer (1–20) | Opcional | Cuá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
/ats/interviews/{interviewId}/questions/reorderReordena las preguntas. Recibe la lista completa de ids en el orden nuevo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (uuid) | Sí | Id de la entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| ids | string[] (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
/ats/interviews/{interviewId}/questions/statusPone 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (uuid) | Sí | Id de la entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| questionIds | string[] (uuid) | Sí | De 1 a 200 preguntas de esta entrevista. |
| status | PROPOSED | CONFIRMED | DISMISSED | Sí | 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
/ats/interviews/{interviewId}/questions/suggestionsAgrega 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| interviewId | string (uuid) | Sí | Id de la entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| question | string | Sí | De 1 a 2000 caracteres. |
| criterionId | string (uuid) | null | Sí | 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}
/ats/questions/{questionId}Edita el texto de una pregunta o la mueve entre confirmada y descartada.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| questionId | string (uuid) | Sí | Id de la pregunta de entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| question | string | Opcional | Texto nuevo, de 1 a 2000 caracteres. |
| status | PROPOSED | CONFIRMED | DISMISSED | Opcional | `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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| questionId | string (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
/ats/questions/{questionId}/answerContesta 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| questionId | string (uuid) | Sí | Id de la pregunta de entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| content | string | Sí | 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
/ats/questions/{questionId}/answerQuita 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| questionId | string (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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| answerId | string (uuid) | Sí | Id de la respuesta. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| content | string | Opcional | Texto corregido, de 1 a 8000 caracteres. |
| review | NEEDS_REVIEW | CONFIRMED | DISMISSED | Opcional | Estado 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
/ats/interview-typesLista 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
/ats/interview-typesCrea un tipo de entrevista. Sólo OWNER.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | De 1 a 80 caracteres, único en el workspace. |
| instruction | string | Sí | Qué tiene que averiguar, de 1 a 1000 caracteres. |
| firstSources | string[] | 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}
/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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| typeId | string (uuid) | Sí | Id del tipo de entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Opcional | De 1 a 80 caracteres. |
| instruction | string | Opcional | De 1 a 1000 caracteres. |
| firstSources | string[] | Opcional | Fuentes 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
/ats/interview-types/{typeId}/archivedArchiva un tipo (deja de ofrecerse; las entrevistas que lo usan lo conservan) o lo restaura. Sólo OWNER.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| typeId | string (uuid) | Sí | Id del tipo de entrevista. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| archived | boolean | Sí | `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)