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:
create_interviewagenda o registra la entrevista.generate_interview_questionspropone preguntas a partir de lo que falta saber del candidato.set_interview_transcriptcarga la transcripción ygenerate_answers_from_transcriptredacta las respuestas.generate_scorecardpropone el puntaje por criterio; la persona evaluadora lo adopta en la app.generate_reportconstruye el reporte ydraft_reportpropone 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.
/actions/create_interviewBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | null | Opcional | Nombre de la entrevista. Hasta 200 caracteres. |
| stageId | string (uuid) | null | Opcional | Etapa del pipeline a la que pertenece. Por defecto, la etapa actual del candidato. |
| interviewerId | string (uuid) | null | Opcional | Quié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. |
| scheduledAt | string (datetime) | null | Opcional | Cuándo está agendada. Fecha y hora ISO 8601 con zona horaria. |
| heldAt | string (datetime) | null | Opcional | Cuándo se hizo. Fecha y hora ISO 8601 con zona horaria. |
| meetingUrl | string (url) | null | Opcional | Link de la reunión (http o https). Hasta 2.000 caracteres. |
| attendeeIds | string[] (uuid) | null | Opcional | Otras 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. |
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| type | string | Opcional | Nombre 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ódigo | HTTP | Cuándo |
|---|---|---|
UNKNOWN_INTERVIEW_TYPE | 400 | type no es un tipo de entrevista activo del workspace. |
NOT_FOUND | 404 | La 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.
/actions/update_interviewBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | null | Opcional | Nombre de la entrevista. Hasta 200 caracteres. |
| stageId | string (uuid) | null | Opcional | Etapa del pipeline a la que pertenece. |
| interviewerId | string (uuid) | null | Opcional | Quién entrevista. Son userId de GET /account/members, nunca memberId: son ids distintos de la misma persona, y el equivocado se rechaza. |
| scheduledAt | string (datetime) | null | Opcional | Cuándo está agendada. Fecha y hora ISO 8601 con zona horaria. |
| heldAt | string (datetime) | null | Opcional | Cuándo se hizo. Fecha y hora ISO 8601 con zona horaria. |
| meetingUrl | string (url) | null | Opcional | Link de la reunión (http o https). Hasta 2.000 caracteres. |
| attendeeIds | string[] (uuid) | null | Opcional | Otras 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. |
| notes | string | null | Opcional | Notas de quien entrevista. Hasta 20.000 caracteres. |
| cancelled | boolean | Opcional | true la cancela; false la restablece. |
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| interviewId | string (uuid) | Sí | Id de la entrevista (GET /ats/applications/{applicationId}/interviews). |
| type | string | Opcional | Nombre 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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_TYPE | 400 | type no es un tipo activo del workspace. |
INVALID | 400 | No 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:
questionreemplaza el texto.status:CONFIRMEDla conserva,DISMISSEDla aparta (sigue visible y se puede recuperar) yPROPOSEDla devuelve a propuesta.
Para «borrar» una pregunta, descártala con DISMISSED.
/actions/update_interview_questionBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| interviewId | string (uuid) | Sí | Id de la entrevista (GET /ats/applications/{applicationId}/interviews). |
| questionId | string (uuid) | Sí | Id de la pregunta (de GET /ats/interviews/{interviewId}/questions, o de la tool list_interview_questions por MCP). |
| question | string | Opcional | Texto nuevo de la pregunta. Hasta 2.000 caracteres. |
| status | enum | Opcional | Estado 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ódigo | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | No se envió question ni status. |
NOT_FOUND | 404 | La 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ó.
/actions/set_interview_transcriptBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| interviewId | string (uuid) | Sí | Id de la entrevista (GET /ats/applications/{applicationId}/interviews). |
| transcript | string | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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.
/actions/generate_interview_questionsBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| interviewId | string (uuid) | Sí | Id de la entrevista (GET /ats/applications/{applicationId}/interviews). |
| count | integer | Opcional | Cuá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ódigo | HTTP | Cuándo |
|---|---|---|
NOTHING_TO_ASK | 409 | No queda nada abierto sobre el candidato, o la vacante no tiene criterios. |
NOT_FOUND | 404 | La entrevista no es de esta postulación. |
USAGE_WINDOW | 402 | Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt). |
USAGE_EXHAUSTED | 402 | Se agotó el uso de IA del mes. |
TEAM_WINDOW | 402 | Se alcanzó el límite de cinco horas del uso compartido del equipo. |
TEAM_USAGE_EXHAUSTED | 402 | Se 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_NOTESsi la entrevista no tiene transcripción ni notas (se cargan conset_interview_transcriptoupdate_interview). - Responde
NO_QUESTIONSsi todas las preguntas ya tienen una respuesta confirmada, o la entrevista no tiene preguntas.
/actions/generate_answers_from_transcriptBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| interviewId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
NO_TRANSCRIPT_OR_NOTES | 400 | La entrevista no tiene transcripción ni notas. suggestions trae set_interview_transcript y update_interview. |
NO_QUESTIONS | 400 | No queda ninguna pregunta sin respuesta confirmada. suggestions trae generate_interview_questions. |
NOT_FOUND | 404 | La entrevista no es de esta postulación. |
USAGE_WINDOW | 402 | Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt). |
USAGE_EXHAUSTED | 402 | Se agotó el uso de IA del mes. |
TEAM_WINDOW | 402 | Se alcanzó el límite de cinco horas del uso compartido del equipo. |
TEAM_USAGE_EXHAUSTED | 402 | Se 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_CRITERIAsi la vacante todavía no tiene criterios de evaluación (write_evaluation_criteria). - Responde
NO_EVIDENCEsi ninguna entrevista del candidato tiene transcripción, respuestas confirmadas o notas.
/actions/generate_scorecardBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/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ódigo | HTTP | Cuándo |
|---|---|---|
NO_CRITERIA | 409 | La vacante no tiene criterios de evaluación. suggestions trae write_evaluation_criteria. |
NO_EVIDENCE | 409 | Ninguna entrevista tiene transcripción, respuestas confirmadas o notas. suggestions trae set_interview_transcript. |
NOT_FOUND | 404 | La postulación no existe en el workspace. |
USAGE_WINDOW | 402 | Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt). |
USAGE_EXHAUSTED | 402 | Se agotó el uso de IA del mes. |
TEAM_WINDOW | 402 | Se alcanzó el límite de cinco horas del uso compartido del equipo. |
TEAM_USAGE_EXHAUSTED | 402 | Se 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
blockcorre 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.
/actions/draft_reportBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
| block | enum | Opcional | Bloque 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | El reporte nunca se construyó, o la postulación no existe. |
REPORT_IN_PROGRESS | 409 | Ya hay otra corrida de IA sobre este reporte. Espera a que termine. |
USAGE_WINDOW | 402 | Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt). |
USAGE_EXHAUSTED | 402 | Se agotó el uso de IA del mes. |
TEAM_USAGE_EXHAUSTED | 402 | Se 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.
/actions/generate_reportBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_READY | 409 | Falta algo para construir el reporte; missing dice qué. |
NOT_FOUND | 404 | La 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.
/actions/write_considerationBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| kind | enum | Sí | Tipo de consideración. Valores: REQUIREMENT_EXCEPTION, GAP, RISK, DATA_RELIABILITY, COMPENSATION, HIGHLIGHT. |
| title | string | Sí | Título que lee el cliente. Hasta 200 caracteres. |
| body | string | Sí | Texto que lee el cliente. Acepta texto enriquecido (HTML). Hasta 8.000 caracteres. |
| applicationId | string (uuid) | Sí | Id de la postulación del candidato (GET /job-posts/{jobPostId}/applications). |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La postulación no existe en el workspace. |
Para incluirla en el reporte, construye una versión nueva con generate_report.