Reclee

Entrevistas y evaluación

Acciones para agendar entrevistas, cargar transcripciones, generar preguntas y respuestas, proponer el scorecard y construir el reporte del candidato.

Estas acciones cubren lo que pasa después de que un candidato entra al pipeline: las entrevistas, su evaluación y el reporte que lee el cliente. Todas trabajan sobre una postulación (applicationId). Cómo se llama a una acción y los errores comunes están en Acciones.

El flujo típico:

  1. create_interview agenda o registra la entrevista.
  2. generate_interview_questions propone preguntas a partir de lo que falta saber del candidato.
  3. set_interview_transcript carga la transcripción y generate_answers_from_transcript redacta las respuestas.
  4. generate_scorecard propone el puntaje por criterio; la persona evaluadora lo adopta en la app.
  5. generate_report construye el reporte y draft_report propone sus textos.

Las acciones GENERATE escriben propuestas: nada de lo que generan cuenta (ni llega al cliente) hasta que una persona lo revisa en la app.

create_interview

Familia: DO · No consume créditos ni uso del plan.

Agenda o registra una entrevista en la postulación de un candidato. type es el nombre de uno de los tipos de entrevista del workspace, tal como los lista GET /ats/interview-types; omitido, es Screening. Un nombre desconocido o archivado responde UNKNOWN_INTERVIEW_TYPE: no lo inventes, léelo de la lista.

interviewerId y attendeeIds son el userId de cada persona (GET /account/members), nunca su memberId; un id que no es de un miembro activo del workspace responde NOT_FOUND.

POST/actions/create_interview

Body

CampoTipoRequeridoDescripción
namestring | nullOpcionalNombre de la entrevista. Hasta 200 caracteres.
stageIdstring (uuid) | nullOpcionalEtapa del pipeline a la que pertenece. Por defecto, la etapa actual del candidato.
interviewerIdstring (uuid) | nullOpcionalQuién entrevista. Por defecto, la persona dueña de la API key. Son userId de GET /account/members, nunca memberId: son ids distintos de la misma persona, y el equivocado se rechaza.
scheduledAtstring (datetime) | nullOpcionalCuándo está agendada. Fecha y hora ISO 8601 con zona horaria.
heldAtstring (datetime) | nullOpcionalCuándo se hizo. Fecha y hora ISO 8601 con zona horaria.
meetingUrlstring (url) | nullOpcionalLink de la reunión (http o https). Hasta 2.000 caracteres.
attendeeIdsstring[] (uuid) | nullOpcionalOtras personas presentes. Son userId de GET /account/members, nunca memberId: son ids distintos de la misma persona, y el equivocado se rechaza. Hasta 20 elementos.
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
typestringOpcionalNombre de un tipo de entrevista activo del workspace (GET /ats/interview-types), sin distinguir mayúsculas. Omitido: el tipo de sistema, Screening. Hasta 80 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/create_interview \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "type": "Técnica",
    "name": "Entrevista técnica con el equipo de pagos",
    "interviewerId": "4d5c6b7a-8f9e-4d0c-9b1a-2f3e4d5c6b7a",
    "scheduledAt": "2026-10-28T15:00:00-03:00",
    "meetingUrl": "https://meet.example.com/abc-defg-hij",
    "attendeeIds": [
      "5e6d7c8b-9a0f-4e1d-8c2b-3a4f5e6d7c8b"
    ]
  }'

Respuesta

200 OK

{
  "data": {
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d"
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ]
}

Errores

CódigoHTTPCuándo
UNKNOWN_INTERVIEW_TYPE400type no es un tipo de entrevista activo del workspace.
NOT_FOUND404La postulación no existe, stageId no es de su vacante, o un interviewerId/attendeeIds no es un miembro activo (por ejemplo, si enviaste un memberId).

Siguientes pasos: generate_interview_questions y, después de la entrevista, set_interview_transcript.

update_interview

Familia: DO · No consume créditos ni uso del plan.

Edita una entrevista ya registrada: todo salvo la transcripción, que va por set_interview_transcript. Solo cambian los campos que envías; el resto queda igual. Hace falta al menos uno.

cancelled: true la cancela y false la restablece. Una entrevista no se borra: se cancela y conserva sus preguntas, transcripción y notas.

Las mismas reglas que en create_interview: type es un nombre del catálogo, y interviewerId / attendeeIds son userId.

POST/actions/update_interview

Body

CampoTipoRequeridoDescripción
namestring | nullOpcionalNombre de la entrevista. Hasta 200 caracteres.
stageIdstring (uuid) | nullOpcionalEtapa del pipeline a la que pertenece.
interviewerIdstring (uuid) | nullOpcionalQuién entrevista. Son userId de GET /account/members, nunca memberId: son ids distintos de la misma persona, y el equivocado se rechaza.
scheduledAtstring (datetime) | nullOpcionalCuándo está agendada. Fecha y hora ISO 8601 con zona horaria.
heldAtstring (datetime) | nullOpcionalCuándo se hizo. Fecha y hora ISO 8601 con zona horaria.
meetingUrlstring (url) | nullOpcionalLink de la reunión (http o https). Hasta 2.000 caracteres.
attendeeIdsstring[] (uuid) | nullOpcionalOtras personas presentes. Son userId de GET /account/members, nunca memberId: son ids distintos de la misma persona, y el equivocado se rechaza. Hasta 20 elementos.
notesstring | nullOpcionalNotas de quien entrevista. Hasta 20.000 caracteres.
cancelledbooleanOpcionaltrue la cancela; false la restablece.
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
interviewIdstring (uuid)SíId de la entrevista (GET /ats/applications/{applicationId}/interviews).
typestringOpcionalNombre de un tipo de entrevista del workspace (GET /ats/interview-types). Hasta 80 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_interview \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
    "heldAt": "2026-10-28T15:05:00-03:00",
    "notes": "Resolvió bien el ejercicio de diseño. Dudas con Kubernetes."
  }'

Respuesta

200 OK

{
  "data": {
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d"
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La entrevista no es de esta postulación, stageId no es de la vacante, o un id de persona no es un miembro activo.
UNKNOWN_INTERVIEW_TYPE400type no es un tipo activo del workspace.
INVALID400No se envió ningún campo para cambiar.

Las entrevistas de un candidato se leen con GET /ats/applications/{applicationId}/interviews.

update_interview_question

Familia: DO · No consume créditos ni uso del plan.

Reescribe una pregunta de una entrevista o cambia su estado. Las preguntas se editan, no se borran, porque alguien puede haberlas respondido. Envía al menos uno de los dos:

  • question reemplaza el texto.
  • status: CONFIRMED la conserva, DISMISSED la aparta (sigue visible y se puede recuperar) y PROPOSED la devuelve a propuesta.

Para «borrar» una pregunta, descártala con DISMISSED.

POST/actions/update_interview_question

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
interviewIdstring (uuid)SíId de la entrevista (GET /ats/applications/{applicationId}/interviews).
questionIdstring (uuid)SíId de la pregunta (de GET /ats/interviews/{interviewId}/questions, o de la tool list_interview_questions por MCP).
questionstringOpcionalTexto nuevo de la pregunta. Hasta 2.000 caracteres.
statusenumOpcionalEstado nuevo de la pregunta. Valores: PROPOSED, CONFIRMED, DISMISSED.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_interview_question \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
    "questionId": "1c2d3e4f-5a6b-4c7d-8e8f-9a0b1c2d3e4f",
    "question": "¿Cómo diseñarías la idempotencia de un endpoint de cobros?",
    "status": "CONFIRMED"
  }'

Respuesta

200 OK

{
  "data": {
    "questionId": "1c2d3e4f-5a6b-4c7d-8e8f-9a0b1c2d3e4f"
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ]
}

Errores

CódigoHTTPCuándo
INVALID400No se envió question ni status.
NOT_FOUND404La pregunta no es de esa entrevista, o la entrevista no es de esa postulación.

Las preguntas, con sus ids, se leen con GET /ats/interviews/{interviewId}/questions.

set_interview_transcript

Familia: DO · No consume créditos ni uso del plan.

Carga o reemplaza la transcripción de una entrevista (hasta 200.000 caracteres). La entrevista registra cuándo cambió el texto, solo si realmente cambió.

POST/actions/set_interview_transcript

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
interviewIdstring (uuid)SíId de la entrevista (GET /ats/applications/{applicationId}/interviews).
transcriptstringSíTexto completo de la transcripción. Hasta 200.000 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/set_interview_transcript \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
    "transcript": "Entrevistadora: Cuéntame sobre el último sistema de pagos que diseñaste.\nCandidata: En mi trabajo actual migramos los cobros a una cola con reintentos..."
  }'

Respuesta

200 OK

{
  "data": {
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d"
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La entrevista no es de esta postulación.

Con la transcripción cargada, generate_answers_from_transcript redacta las respuestas.

generate_interview_questions

Familia: GENERATE · No consume créditos. Consume uso de IA del plan, informado en cost.

La IA escribe preguntas de entrevista a partir de lo que sigue abierto sobre el candidato: criterios sin datos, puntos flojos y condiciones que nadie verificó. Quedan como propuestas para que el equipo las revise, y se agregan: las preguntas que la entrevista ya tiene nunca se reescriben ni se descartan, así que volver a correrla no pisa ninguna edición.

count es cuántas escribir (8 por defecto). Si hay menos temas abiertos que count, escribe una por tema abierto.

Responde NOTHING_TO_ASK cuando todo está cubierto o la vacante todavía no tiene criterios.

POST/actions/generate_interview_questions

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
interviewIdstring (uuid)SíId de la entrevista (GET /ats/applications/{applicationId}/interviews).
countintegerOpcionalCuántas preguntas escribir. Por defecto 8. Entre 1 y 20.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/generate_interview_questions \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
    "count": 5
  }'

Respuesta

200 OK

{
  "data": {
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
    "requested": 5,
    "openGaps": 3,
    "written": 3,
    "about": [
      "Experiencia con Kubernetes",
      "Liderazgo de equipos",
      "Preaviso"
    ]
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ],
  "cost": {
    "aiUsagePct": 0.001,
    "teamUsagePct": 0,
    "credits": 0,
    "billedLater": false
  }
}

requested es cuántas pediste, openGaps cuántos temas abiertos había y written cuántas escribió; about nombra los temas sobre los que preguntó.

Errores

CódigoHTTPCuándo
NOTHING_TO_ASK409No queda nada abierto sobre el candidato, o la vacante no tiene criterios.
NOT_FOUND404La entrevista no es de esta postulación.
USAGE_WINDOW402Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt).
USAGE_EXHAUSTED402Se agotó el uso de IA del mes.
TEAM_WINDOW402Se alcanzó el límite de cinco horas del uso compartido del equipo.
TEAM_USAGE_EXHAUSTED402Se agotó el uso compartido del equipo en el mes.

Para editar o descartar una: update_interview_question.

generate_answers_from_transcript

Familia: GENERATE · No consume créditos. Consume uso de IA del plan, informado en cost.

La IA lee la transcripción y las notas de quien entrevistó (lo que la entrevista tenga; ambas si tiene las dos) y escribe una respuesta por cada pregunta todavía abierta. Una pregunta que ninguna de las dos cubre queda marcada como no cubierta.

Cada respuesta queda pendiente de revisión: la entrevista no está documentada hasta que alguien las revisa. Una respuesta ya confirmada nunca se toca; solo se reemplaza un borrador automático que nadie revisó.

  • Responde NO_TRANSCRIPT_OR_NOTES si la entrevista no tiene transcripción ni notas (se cargan con set_interview_transcript o update_interview).
  • Responde NO_QUESTIONS si todas las preguntas ya tienen una respuesta confirmada, o la entrevista no tiene preguntas.
POST/actions/generate_answers_from_transcript

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
interviewIdstring (uuid)SíId de la entrevista (GET /ats/applications/{applicationId}/interviews).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/generate_answers_from_transcript \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d"
  }'

Respuesta

200 OK

{
  "data": {
    "interviewId": "6a7b8c9d-0e1f-4a2b-9c3d-4e5f6a7b8c9d",
    "drafted": 6,
    "notCovered": 1
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ],
  "cost": {
    "aiUsagePct": 0.003,
    "teamUsagePct": 0,
    "credits": 0,
    "billedLater": false
  }
}

drafted cuenta las respuestas escritas a partir de la transcripción o las notas, y notCovered las preguntas que no cubrieron. Son dos conteos separados que nunca se superponen: el total de respuestas nuevas es la suma.

Errores

CódigoHTTPCuándo
NO_TRANSCRIPT_OR_NOTES400La entrevista no tiene transcripción ni notas. suggestions trae set_interview_transcript y update_interview.
NO_QUESTIONS400No queda ninguna pregunta sin respuesta confirmada. suggestions trae generate_interview_questions.
NOT_FOUND404La entrevista no es de esta postulación.
USAGE_WINDOW402Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt).
USAGE_EXHAUSTED402Se agotó el uso de IA del mes.
TEAM_WINDOW402Se alcanzó el límite de cinco horas del uso compartido del equipo.
TEAM_USAGE_EXHAUSTED402Se agotó el uso compartido del equipo en el mes.

Con las respuestas revisadas, sigue generate_scorecard.

generate_scorecard

Familia: GENERATE · No consume créditos. Consume uso de IA del plan, informado en cost.

La IA propone la evaluación del candidato a partir de todo lo que produjeron sus entrevistas (transcripciones, respuestas confirmadas y notas) y de las condiciones: un puntaje y un comentario por criterio de evaluación, con su cita, las consideraciones para el cliente y el texto de la recomendación.

Todo queda como propuesta que no cuenta: el resultado, la completitud y el reporte solo ven un puntaje cuando la persona evaluadora lo adopta en la pantalla del candidato. Un criterio que alguien ya puntuó no se vuelve a proponer.

  • Responde NO_CRITERIA si la vacante todavía no tiene criterios de evaluación (write_evaluation_criteria).
  • Responde NO_EVIDENCE si ninguna entrevista del candidato tiene transcripción, respuestas confirmadas o notas.
POST/actions/generate_scorecard

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/generate_scorecard \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60"
  }'

Respuesta

200 OK

{
  "data": {
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "written": 6,
    "unscored": 1,
    "recommendationTextProposed": true,
    "scoredCount": 0,
    "totalCount": 6,
    "partial": true
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": []
  },
  "cost": {
    "aiUsagePct": 0.004,
    "teamUsagePct": 0,
    "credits": 0,
    "billedLater": false
  }
}

Devuelve cuántas propuestas escribió y cuánto avanzó el scorecard, nunca los puntajes: esos se leen en la app o en GET /ats/applications/{applicationId}/scorecard. unscored cuenta las propuestas sin puntaje (el comentario dice qué falta), scoredCount / totalCount cuántos criterios tienen puntaje adoptado y partial si todavía falta alguno. Cuando el scorecard está completo, next sugiere generate_report.

Después de que esta acción escribió propuestas, un reporte rechazado con NOT_READY por el scorecard está esperando que el evaluador las adopte, no propuestas nuevas: no la vuelvas a llamar salvo que alguien lo pida.

Errores

CódigoHTTPCuándo
NO_CRITERIA409La vacante no tiene criterios de evaluación. suggestions trae write_evaluation_criteria.
NO_EVIDENCE409Ninguna entrevista tiene transcripción, respuestas confirmadas o notas. suggestions trae set_interview_transcript.
NOT_FOUND404La postulación no existe en el workspace.
USAGE_WINDOW402Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt).
USAGE_EXHAUSTED402Se agotó el uso de IA del mes.
TEAM_WINDOW402Se alcanzó el límite de cinco horas del uso compartido del equipo.
TEAM_USAGE_EXHAUSTED402Se agotó el uso compartido del equipo en el mes.

draft_report

Familia: GENERATE · No consume créditos. Consume uso de IA del plan, informado en cost.

La IA propone textos para el reporte ya construido del candidato, como sugerencias que una persona adopta o descarta en su pantalla: el perfil narrativo, la recomendación, un cumple / no cumple por requisito, los comentarios de la evaluación, las consideraciones y las condiciones.

  • Cada texto vacío recibe una propuesta; uno ya escrito, solo si la IA lo cambiaría.
  • Con block corre sobre ese bloque solo.
  • Una corrida reemplaza las propuestas anteriores de los bloques que recorre, incluso una descartada.
  • Nada de lo que escribe llega al cliente hasta que alguien lo adopta, y no crea una versión nueva del reporte.

Responde NOT_FOUND si el reporte nunca se construyó (se construye con generate_report) y REPORT_IN_PROGRESS si ya hay otra corrida de IA sobre este reporte (desde otra pestaña, otra persona o la API): termina sola, así que espera en lugar de repetirla.

POST/actions/draft_report

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).
blockenumOpcionalBloque sobre el que correr. Omitido: todo el reporte. Valores: recommendation, requirements, evaluation, profile, considerations, conditions.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/draft_report \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "block": "recommendation"
  }'

Respuesta

200 OK

{
  "data": {
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "version": 2,
    "requirementsProposed": 0,
    "textsProposed": 1
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ],
  "cost": {
    "aiUsagePct": 0.002,
    "teamUsagePct": 0,
    "credits": 0,
    "billedLater": false
  }
}

version es la versión del reporte donde quedaron las propuestas. requirementsProposed y textsProposed cuentan cuántas propuestas esperan revisión; los textos se leen en la app.

Errores

CódigoHTTPCuándo
NOT_FOUND404El reporte nunca se construyó, o la postulación no existe.
REPORT_IN_PROGRESS409Ya hay otra corrida de IA sobre este reporte. Espera a que termine.
USAGE_WINDOW402Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt).
USAGE_EXHAUSTED402Se agotó el uso de IA del mes.
TEAM_USAGE_EXHAUSTED402Se agotó el uso compartido del equipo en el mes.

generate_report

Familia: DO · No consume créditos ni uso del plan.

Construye el reporte del candidato como una versión nueva, sin IA y sin costo: cada bloque se copia tal como lo dejaron las personas. La recomendación y su texto, el scorecard y las consideraciones revisadas salen de la evaluación; las condiciones, de las entrevistas; el perfil, del registro del workspace. El perfil narrativo y los requisitos que alguien confirmó en la versión anterior se conservan. No le envía nada al cliente.

Si falta algo responde NOT_READY, con missing diciendo qué:

  • scorecard: algún criterio no tiene puntaje;
  • considerations: alguna consideración espera revisión en la pantalla del candidato (ninguna acción la resuelve);
  • recommendation: la recomendación todavía no tiene texto.

Para scorecard y recommendation, suggestions trae generate_scorecard, que propone los puntajes y la recomendación para que la persona evaluadora los adopte.

POST/actions/generate_report

Body

CampoTipoRequeridoDescripción
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/generate_report \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60"
  }'

Respuesta

200 OK

{
  "data": {
    "reportId": "3e4f5a6b-7c8d-4e9f-a0a1-b2c3d4e5f6a7",
    "version": 1
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "draft_report",
        "input": {
          "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60"
        }
      }
    ]
  }
}

Nunca devuelve el contenido: el reporte es del cliente y se lee en la app o en GET /ats/applications/{applicationId}/report. next sugiere draft_report para proponer lo que todavía falta.

Errores

CódigoHTTPCuándo
NOT_READY409Falta algo para construir el reporte; missing dice qué.
NOT_FOUND404La postulación no existe en el workspace.

write_consideration

Familia: DO · No consume créditos ni uso del plan.

Escribe una consideración sobre el candidato: lo que el cliente tiene que leer más allá de los números. No hay consideraciones internas: todas se publican al cliente, así que title y body son las palabras que va a leer. Se guarda tal cual, queda confirmada y entra al reporte como está escrita.

Tipos (kind):

  • REQUIREMENT_EXCEPTION: un requisito que no cumple y por qué se lo presenta igual;
  • GAP: una brecha;
  • RISK: un riesgo;
  • DATA_RELIABILITY: cuánto confiar en los datos;
  • COMPENSATION: sobre su compensación;
  • HIGHLIGHT: algo a su favor.

Nadie borra una consideración: una que no debe publicarse se descarta en la pantalla del candidato.

POST/actions/write_consideration

Body

CampoTipoRequeridoDescripción
kindenumSíTipo de consideración. Valores: REQUIREMENT_EXCEPTION, GAP, RISK, DATA_RELIABILITY, COMPENSATION, HIGHLIGHT.
titlestringSíTítulo que lee el cliente. Hasta 200 caracteres.
bodystringSíTexto que lee el cliente. Acepta texto enriquecido (HTML). Hasta 8.000 caracteres.
applicationIdstring (uuid)SíId de la postulación del candidato (GET /job-posts/{jobPostId}/applications).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/write_consideration \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
    "kind": "REQUIREMENT_EXCEPTION",
    "title": "Inglés intermedio",
    "body": "No llega al nivel avanzado pedido, pero el equipo del cliente trabaja en español y lo validó en la entrevista."
  }'

Respuesta

200 OK

{
  "data": {
    "considerationId": "4f5a6b7c-8d9e-4f0a-b1b2-c3d4e5f6a7b8",
    "status": "CONFIRMED"
  },
  "links": [
    {
      "kind": "application",
      "id": "5e8d2f1a-6c3b-4a9e-8d7f-1b2c3d4e5f60",
      "label": "Lucía Fernández",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/ats/table?profileId=9b3c7d1e-2f4a-4b6c-a8d9-0e1f2a3b4c5d"
    }
  ]
}

status es siempre CONFIRMED: una consideración escrita por una persona no espera revisión.

Errores

CódigoHTTPCuándo
NOT_FOUND404La postulación no existe en el workspace.

Para incluirla en el reporte, construye una versión nueva con generate_report.

En esta página