Vacantes
Vacantes, su equipo, notas, criterios, preguntas de screening, etapas, links compartidos y match score.
Las rutas /job-posts crean y leen vacantes y todo lo que se configura sobre ellas: el equipo, el embudo de etapas, los criterios de sourcing y de evaluación, las preguntas de screening, las condiciones, las notas y los links para el cliente. Lo que pasa con cada candidato dentro de la vacante está en ATS.
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 comunes y su relación con las acciones) está en el índice de la referencia. Cada endpoint lista abajo solo sus errores propios.
Vacantes
Una vacante (job post) es la búsqueda que lleva la agencia: su descripción, su equipo, su embudo de etapas y sus criterios. Pasa por tres estados: DRAFT (borrador, no recibe candidatos), ACTIVE y CLOSED.
GET /job-posts
/job-postsLista las vacantes del workspace, de la más nueva a la más vieja. Cada fila es la vacante completa, con el mismo formato que GET /job-posts/{jobPostId}.
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| status | DRAFT | ACTIVE | CLOSED | Opcional | Filtra por estado. |
| page | integer | Opcional | Página, desde 1. Por defecto 1. |
| pageSize | integer | Opcional | Filas por página, de 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts?status=ACTIVE&page=1&pageSize=20" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"status": "ACTIVE",
"openings": 1,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr"
}
],
"total": 14,
"page": 1,
"pageSize": 20
}POST /job-posts
/job-postsCrea una vacante. Nace en DRAFT con el embudo de seis etapas por defecto; para recibir candidatos hay que publicarla con PUT /job-posts/{jobPostId}/status. Devuelve la vacante creada.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| title | string | Sí | De 1 a 200 caracteres. |
| requestId | string (uuid) | null | Opcional | Pedido del CRM que origina la vacante. Al crear, lo que no mandes se completa con los datos del pedido y su lead. |
| description | string | null | Opcional | Descripción en HTML, hasta 50.000 caracteres. Se limpia al guardar. |
| seniority | enum | null | Opcional | Uno de: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE. |
| employmentType | enum | null | Opcional | Uno de: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER. |
| workplaceType | enum | null | Opcional | REMOTE, HYBRID u ON_SITE. |
| location | string | null | Opcional | Texto libre, hasta 200 caracteres. |
| country | string | null | Opcional | Código ISO 3166-1 alfa-2 (por ejemplo, ES o AR). |
| city | string | null | Opcional | De 3 a 200 caracteres. |
| salaryMin | number | null | Opcional | Mayor o igual a 0 y no mayor que salaryMax. Un salario exige salaryPeriod y currencyCode. |
| salaryMax | number | null | Opcional | Mayor o igual a 0. |
| currencyCode | string | null | Opcional | Código de moneda ISO 4217 (EUR, USD, ARS…). |
| salaryPeriod | enum | null | Opcional | HOURLY, DAILY, MONTHLY o YEARLY. |
| targetStartDate | string (date) | null | Opcional | Fecha de inicio buscada, AAAA-MM-DD. |
| openings | integer | Opcional | Posiciones a cubrir, de 1 a 500. Por defecto 1. |
| responsibilities | string[] | Opcional | Hasta 100 ítems de hasta 2000 caracteres. Por defecto vacío. |
| requirements | string[] | Opcional | Requisitos obligatorios. Mismo límite. Por defecto vacío. |
| niceToHaves | string[] | Opcional | Requisitos deseables. Mismo límite. Por defecto vacío. |
| benefits | string[] | Opcional | Beneficios. Mismo límite. Por defecto vacío. |
| companyPitch | string | null | Opcional | Párrafo sobre la empresa, hasta 50.000 caracteres. |
| bonus | string | null | Opcional | Hasta 2000 caracteres. |
| equity | string | null | Opcional | Hasta 2000 caracteres. |
| ownerId | string (uuid) | null | Opcional | Id de membresía de quien lleva la vacante. Al crear, si no lo mandas, queda quien llama; null la deja sin responsable. |
| matchThresholdPct | number | Opcional | Umbral del match score para calificar, de 0 a 100. Por defecto 50. |
| matchScoreTrigger | ON_APPLY | MANUAL | Opcional | ON_APPLY calcula el match score de cada postulación que entra (consume uso, requiere asiento); MANUAL solo cuando se pide. |
| recommendationThreshold | number | Opcional | Nota del scorecard, de 0 a 5, desde la que se recomienda a un candidato. |
| draftStep | integer | Opcional | Paso del asistente de creación en el que quedó un borrador (desde 1). |
| publishToCareerSite | boolean | Opcional | Si la vacante se publica en el sitio de empleo cuando esté activa. |
| showSalary | boolean | Opcional | Si el sitio de empleo muestra el salario. |
| showClient | boolean | Opcional | Si el sitio de empleo muestra el cliente. |
| showApplicantCount | boolean | Opcional | Si el sitio de empleo muestra cuántas personas se postularon. |
| contentLocale | es | en | Opcional | Idioma de todo lo que la vacante muestra hacia afuera (sitio de empleo, preguntas, informe). Si no lo mandas, se hereda. |
Sin asiento (rol COLLABORATOR), matchScoreTrigger: "ON_APPLY" se guarda como MANUAL.
curl -X POST "https://app.reclee.com/api/v1/job-posts" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"title":"Backend Engineer Sr.","seniority":"MID_SENIOR_LEVEL","employmentType":"FULL_TIME","workplaceType":"HYBRID","country":"ES","city":"Madrid","salaryMin":55000,"salaryMax":70000,"currencyCode":"EUR","salaryPeriod":"YEARLY"}'Respuesta (extracto)
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"status": "DRAFT",
"openings": 1,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr"
}Errores
INVALID(400): un campo no pasa la validación; por ejemplo, un salario sinsalaryPeriodo sincurrencyCode, osalaryMinmayor quesalaryMax.REQUEST_ALREADY_LINKED(409): el pedido ya respalda otra vacante.
Acción equivalente: create_job_post.
GET /job-posts/{jobPostId}
/job-posts/{jobPostId}Devuelve una vacante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"description": "<p>Buscamos una persona para liderar la evolución de nuestra plataforma de pagos…</p>",
"seniority": "MID_SENIOR_LEVEL",
"employmentType": "FULL_TIME",
"workplaceType": "HYBRID",
"location": "Madrid, España",
"salaryMin": 55000,
"salaryMax": 70000,
"currencyCode": "EUR",
"salaryPeriod": "YEARLY",
"matchThresholdPct": 60,
"status": "ACTIVE",
"openedAt": "2026-09-29T09:12:44.218+00:00",
"closedAt": null,
"closeReason": null,
"createdAt": "2026-09-28T10:00:00.000+00:00",
"targetStartDate": "2026-12-01",
"openings": 1,
"country": "ES",
"city": "Madrid",
"responsibilities": ["Diseñar y mantener los servicios de cobro", "Acompañar a dos personas del equipo"],
"requirements": ["5+ años con Go", "Experiencia con PostgreSQL en producción"],
"niceToHaves": ["Experiencia en fintech"],
"benefits": ["Seguro médico", "Presupuesto de formación"],
"companyPitch": "Somos una fintech de 80 personas que procesa pagos para comercios de toda Europa.",
"bonus": "Hasta 10% anual",
"equity": null,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"draftStep": 6,
"publishToCareerSite": true,
"showSalary": false,
"showClient": false,
"contentLocale": "es",
"showApplicantCount": false,
"matchScoreTrigger": "ON_APPLY",
"recommendationThreshold": 3.5,
"handle": "backend-engineer-sr"
}ownerId es un id de membresía. handle es su dirección en el sitio de empleo. contentLocale es el idioma de lo que la vacante muestra hacia afuera.
Errores
NOT_FOUND(404)
PATCH /job-posts/{jobPostId}
/job-posts/{jobPostId}Edita una vacante: solo cambia los campos que mandas. Es también como se guarda una descripción o un bloque redactado con IA. El estado no se toca acá (ver PUT …/status) y lo que publica el sitio de empleo (publishToCareerSite, showSalary, showClient, contentLocale, showApplicantCount) se decide en la app: mandarlo es un 400.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| title | string | Opcional | De 1 a 200 caracteres. |
| requestId | string (uuid) | null | Opcional | Pedido del CRM que origina la vacante. Al crear, lo que no mandes se completa con los datos del pedido y su lead. |
| description | string | null | Opcional | Descripción en HTML, hasta 50.000 caracteres. Se limpia al guardar. |
| seniority | enum | null | Opcional | Uno de: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE. |
| employmentType | enum | null | Opcional | Uno de: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER. |
| workplaceType | enum | null | Opcional | REMOTE, HYBRID u ON_SITE. |
| location | string | null | Opcional | Texto libre, hasta 200 caracteres. |
| country | string | null | Opcional | Código ISO 3166-1 alfa-2 (por ejemplo, ES o AR). |
| city | string | null | Opcional | De 3 a 200 caracteres. |
| salaryMin | number | null | Opcional | Mayor o igual a 0 y no mayor que salaryMax. Un salario exige salaryPeriod y currencyCode. |
| salaryMax | number | null | Opcional | Mayor o igual a 0. |
| currencyCode | string | null | Opcional | Código de moneda ISO 4217 (EUR, USD, ARS…). |
| salaryPeriod | enum | null | Opcional | HOURLY, DAILY, MONTHLY o YEARLY. |
| targetStartDate | string (date) | null | Opcional | Fecha de inicio buscada, AAAA-MM-DD. |
| openings | integer | Opcional | Posiciones a cubrir, de 1 a 500. |
| responsibilities | string[] | Opcional | Hasta 100 ítems de hasta 2000 caracteres. |
| requirements | string[] | Opcional | Requisitos obligatorios. Mismo límite. |
| niceToHaves | string[] | Opcional | Requisitos deseables. Mismo límite. |
| benefits | string[] | Opcional | Beneficios. Mismo límite. |
| companyPitch | string | null | Opcional | Párrafo sobre la empresa, hasta 50.000 caracteres. |
| bonus | string | null | Opcional | Hasta 2000 caracteres. |
| equity | string | null | Opcional | Hasta 2000 caracteres. |
| ownerId | string (uuid) | null | Opcional | Id de membresía de quien lleva la vacante. Al crear, si no lo mandas, queda quien llama; null la deja sin responsable. |
| matchThresholdPct | number | Opcional | Umbral del match score para calificar, de 0 a 100. |
| matchScoreTrigger | ON_APPLY | MANUAL | Opcional | ON_APPLY calcula el match score de cada postulación que entra (consume uso, requiere asiento); MANUAL solo cuando se pide. |
| recommendationThreshold | number | Opcional | Nota del scorecard, de 0 a 5, desde la que se recomienda a un candidato. |
| draftStep | integer | Opcional | Paso del asistente de creación en el que quedó un borrador (desde 1). |
Un salario parcial se valida contra lo guardado: mandar solo salaryMin por encima del salaryMax guardado es INVALID. requestId solo se puede cambiar mientras la vacante es borrador o no tiene pedido; para vincular por primera vez usa POST …/request.
curl -X PATCH "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Backend Engineer Sr. (Go)","openings":2}'Respuesta (extracto)
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr. (Go)",
"status": "ACTIVE",
"openings": 2,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr"
}Errores
SEAT_REQUIRED(403): activarmatchScoreTrigger: "ON_APPLY"sin asiento.REQUEST_ALREADY_LINKED(409): el pedido ya respalda otra vacante.JOB_POST_ALREADY_LINKED(409): la vacante activa ya tiene pedido.JOB_POST_CLOSED(409): una vacante cerrada no toma pedido.
Acciones equivalentes: update_job_post, set_job_post_owner, set_recommendation_threshold.
DELETE /job-posts/{jobPostId}
/job-posts/{jobPostId}Borra un borrador en el que nadie trabajó: sin postulaciones, sin corridas de sourcing y sin búsquedas pagas. Es la única vacante que una API key puede borrar, y se va con sus criterios y etapas. Devuelve el id y el título de lo borrado.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl -X DELETE "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{ "id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90", "title": "Backend Engineer Sr." }Errores
JOB_POST_NOT_DELETABLE(409): la vacante no es un borrador o ya tiene historia. La respuesta traesuggestions: [{ "tool": "close_job_post", "input": { "jobPostId": "…" } }]: ciérrala en su lugar.
Acción equivalente: delete_draft_job_post.
PUT /job-posts/{jobPostId}/status
/job-posts/{jobPostId}/statusAbre o cierra una vacante. Pasar un DRAFT a ACTIVE es publicarlo y exige los campos obligatorios; cerrar con posiciones sin cubrir exige closeReason. Un borrador no se cierra: se borra. No toca el pedido del CRM. Devuelve la vacante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| status | ACTIVE | CLOSED | Sí | Estado nuevo. |
| closeReason | string | null | Opcional | Por qué se cierra, hasta 500 caracteres. Obligatorio al cerrar con menos contrataciones que posiciones. |
curl -X PUT "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/status" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"CLOSED","closeReason":"El cliente congeló la búsqueda"}'Respuesta (extracto)
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"status": "CLOSED",
"openings": 1,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr",
"closeReason": "El cliente congeló la búsqueda"
}Errores
PUBLISH_INCOMPLETE(422): al publicar un borrador al que le falta algo;missinglista los campos:description,seniority,employmentType,workplaceType,countryycity(esta solo si esHYBRIDuON_SITE).CLOSE_REASON_REQUIRED(422): cerrar con posiciones sin cubrir sincloseReason; traemissing: ["closeReason"].INVALID(400): también al intentar cerrar un borrador.
Acciones equivalentes: close_job_post, reopen_job_post.
GET /job-posts/{jobPostId}/context
/job-posts/{jobPostId}/contextDevuelve la vacante junto con lo que se muestra al lado: el cliente y el pedido que la originan, quién la lleva, si está visible en el sitio de empleo y el slug del sitio del workspace.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/context" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"post": {
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"status": "ACTIVE",
"openings": 1,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr"
},
"client": {
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"requestTitle": "Backend Sr. para equipo de pagos",
"name": "Pagos Atlas S.L.",
"defaultFeePct": 18,
"guaranteeDays": 90,
"requestFee": { "type": "PERCENTAGE", "pct": 18, "amount": null }
},
"owner": {
"id": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"firstName": "Lucía",
"lastName": "Gómez"
},
"onCareerSite": true,
"workspaceSlug": "talento-norte"
}client es null si la vacante no tiene pedido (una búsqueda interna); owner es null si está sin asignar. requestFee.type es PERCENTAGE, FIXED o MIXED.
Errores
NOT_FOUND(404)
GET /job-posts/contexts
/job-posts/contextsLista las vacantes con su contexto (cliente, responsable) y la fecha de la última actividad, filtradas. Es la lectura del índice de vacantes.
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| search | string | Opcional | Busca en el título, sin distinguir mayúsculas ni acentos. De 1 a 100 caracteres. |
| client | string | Opcional | Busca en el nombre del cliente; deja afuera las vacantes sin pedido. De 1 a 100 caracteres. |
| status | DRAFT | ACTIVE | CLOSED | Opcional | Filtra por estado. |
| ownerId | string (uuid) | Opcional | Id de membresía del responsable. |
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/contexts?status=ACTIVE&client=atlas" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"post": {
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"status": "ACTIVE",
"openings": 1,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr"
},
"client": {
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"requestTitle": "Backend Sr. para equipo de pagos",
"name": "Pagos Atlas S.L.",
"defaultFeePct": 18,
"guaranteeDays": 90,
"requestFee": { "type": "PERCENTAGE", "pct": 18, "amount": null }
},
"owner": {
"id": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"firstName": "Lucía",
"lastName": "Gómez"
},
"onCareerSite": true,
"lastActivityAt": "2026-10-18T16:42:10.000+00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}GET /job-posts/refs
/job-posts/refsLista las vacantes activas como referencia corta (id, título y cliente), para elegir una en un filtro o un selector.
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/refs" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"title": "Backend Engineer Sr.",
"clientName": "Pagos Atlas S.L."
}
],
"total": 1,
"page": 1,
"pageSize": 50
}clientName es null en una vacante sin cliente.
GET /job-posts/refs/open
/job-posts/refs/openLas vacantes a las que se puede sumar a alguien desde el pool de talento, como referencia corta. Hoy devuelve el mismo conjunto que GET /job-posts/refs (solo ACTIVE).
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/refs/open" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"title": "Backend Engineer Sr.",
"clientName": "Pagos Atlas S.L."
}
],
"total": 1,
"page": 1,
"pageSize": 50
}GET /job-posts/{jobPostId}/draft
/job-posts/{jobPostId}/draftDevuelve un borrador entero para retomar su creación: la vacante, su cliente, sus preguntas de screening, criterios de evaluación, condiciones y etapas. Solo responde para vacantes en DRAFT.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/draft" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"jobPost": {
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"status": "DRAFT",
"openings": 1,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr"
},
"client": null,
"screeningQuestions": [
{
"id": "9a1c3e5f-7b9d-4a1c-a3e5-7b9d1a3c5e7f",
"position": 0,
"type": "BOOLEAN",
"prompt": "¿Tienes permiso de trabajo en España?",
"helpText": null,
"isKnockout": true,
"isRequired": true,
"source": "RECRUITER",
"expectedBoolean": true,
"numberOperator": null,
"numberValue": null,
"options": [],
"validOptions": [],
"requiredMatches": null
}
],
"evaluationCriteria": [
{
"id": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
"name": "Diseño de APIs",
"description": "Versionado, errores y contratos estables",
"weightLevel": "HIGH",
"position": 0
}
],
"conditions": [
{
"id": "7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d",
"label": "Pretensión salarial",
"hint": "Bruto anual, en EUR",
"position": 0
}
],
"stages": [
{
"id": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
"name": null,
"templateKey": "SOURCED",
"position": 0,
"isLocked": true
},
{
"id": "a8c0e2f4-6b8d-4a0c-92e4-f6b8d0a2c4e6",
"name": null,
"templateKey": "SCREENING",
"position": 1,
"isLocked": true
}
]
}Errores
NOT_FOUND(404): la vacante no existe o no es un borrador.
POST /job-posts/{jobPostId}/request
/job-posts/{jobPostId}/requestVincula por primera vez la vacante con el pedido del CRM que la originó. Si dos llamadas compiten, la segunda pierde con un 409. Devuelve la vacante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestId | string (uuid) | Sí | Id del pedido. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/request" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"requestId":"3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e"}'Respuesta (extracto)
{
"id": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"requestId": "3c5e7a9b-1d3f-4b5c-8e7a-9b1d3f5a7c9e",
"title": "Backend Engineer Sr.",
"status": "ACTIVE",
"openings": 1,
"ownerId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00",
"handle": "backend-engineer-sr"
}Errores
REQUEST_ALREADY_LINKED(409): el pedido ya respalda otra vacante.JOB_POST_ALREADY_LINKED(409): la vacante ya tiene pedido.JOB_POST_CLOSED(409): una vacante cerrada no toma pedido.
Acción equivalente: link_request_to_job_post.
Redacción con IA
Estas rutas redactan con IA y no guardan nada: devuelven el texto para que una persona lo revise. Guardar es un POST /job-posts (al crear) o un PATCH /job-posts/{jobPostId} (al editar). Consumen uso de IA del plan y pueden tardar varios segundos; mándalas con Idempotency-Key para reintentar sin pagar dos veces.
POST /job-posts/draft
/job-posts/draftLee una descripción de puesto en texto libre y devuelve el formulario de la vacante lleno hasta donde el texto alcanza. No crea la vacante. Lo que el texto no dice vuelve en null, nunca adivinado; filled lista los campos que salieron del texto.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| text | string | Sí | El texto del puesto, de 20 a 20.000 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/draft" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"text":"Buscamos Backend Engineer Sr. con 5+ años de Go para nuestro equipo de pagos en Madrid, modalidad híbrida…"}'Respuesta (extracto)
{
"draft": {
"title": "Backend Engineer Sr.",
"description": "<p>Buscamos una persona para liderar…</p>",
"seniority": "MID_SENIOR_LEVEL",
"employmentType": null,
"workplaceType": "HYBRID",
"location": "Madrid",
"openings": null,
"salaryMin": null,
"salaryMax": null,
"currencyCode": null,
"salaryPeriod": null,
"responsibilities": ["Diseñar y mantener los servicios de cobro"],
"mustHaves": ["5+ años con Go"],
"niceToHaves": [],
"benefits": [],
"companyPitch": null
},
"filled": [
"title",
"description",
"seniority",
"workplaceType",
"location",
"responsibilities",
"mustHaves"
],
"tokens": 1840
}mustHaves va en el campo requirements al crear la vacante.
Errores
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 /job-posts/{jobPostId}/description
/job-posts/{jobPostId}/descriptionReescribe la descripción a partir de los campos que la vacante ya tiene. Devuelve el texto en HTML y no lo guarda.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| sourceText | string | null | Opcional | El texto original del puesto, si lo tienes. Hasta 20.000 caracteres. |
| previous | string | null | Opcional | La versión que se está mirando ahora. Mándala si ya regeneraste una vez: como no se guarda, sin ella el segundo intento se compara contra la descripción vieja. Hasta 20.000 caracteres. |
| instruction | string | null | Opcional | Qué cambiar. Sin instrucción, la reescribe. Hasta 2000 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/description" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"instruction":"Más corta y con foco en el impacto del rol"}'Respuesta
{
"description": "<p>Vas a liderar la evolución de la plataforma de cobros…</p>",
"tokens": 912
}Errores
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.
POST /job-posts/{jobPostId}/content
/job-posts/{jobPostId}/contentRedacta uno de los tres bloques que no son la descripción: las responsabilidades, los requisitos (separados en obligatorios y deseables) o el párrafo sobre la empresa. Uno por llamada; no guarda.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| block | RESPONSIBILITIES | REQUIREMENTS | PITCH | Sí | Qué bloque redactar. |
| previous | string | string[] | null | Opcional | Lo que hay ahora, si ya se generó una vez: un texto (hasta 20.000 caracteres) o una lista (hasta 30 ítems de 500). |
| instruction | string | null | Opcional | Qué cambiar. Hasta 2000 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/content" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"block":"REQUIREMENTS"}'Respuesta
{
"block": "REQUIREMENTS",
"mustHaves": ["5+ años con Go", "Experiencia con PostgreSQL en producción"],
"niceToHaves": ["Experiencia en fintech"]
}La forma depende del bloque: RESPONSIBILITIES devuelve items, REQUIREMENTS devuelve mustHaves y niceToHaves, y PITCH devuelve pitch.
Errores
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.
Métricas
GET /job-posts/{jobPostId}/metrics
/job-posts/{jobPostId}/metricsDevuelve los números de la vacante: días abierta, tiempo hasta la shortlist, contrataciones con su tiempo de cobertura, el embudo por etapa con su conversión, los totales y la corrida de sourcing activa. Las postulaciones retiradas no cuentan.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/metrics" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"daysOpen": 23,
"timeToShortlistDays": 12,
"hires": [],
"totals": { "applications": 48, "qualified": 31, "disqualified": 17, "withdrawn": 2 },
"placements": { "filled": 0, "openings": 1 },
"stages": [
{
"id": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
"name": null,
"templateKey": "SOURCED",
"reached": 31,
"conversionPct": null,
"inStage": { "qualified": 18, "disqualified": 12 }
},
{
"id": "a8c0e2f4-6b8d-4a0c-92e4-f6b8d0a2c4e6",
"name": null,
"templateKey": "SCREENING",
"reached": 13,
"conversionPct": 42,
"inStage": { "qualified": 6, "disqualified": 3 }
}
],
"activeRun": {
"longlistId": "b5d7f9a1-3c5e-4b7d-99a1-a3c5e7b9d1f3",
"targetSize": 20,
"qualified": 13
}
}hires[] trae hiredAt, timeToFillDays y timeToHireDays (en días hábiles). conversionPct es un entero de 0 a 100, null en la primera etapa. activeRun es null cuando no hay una corrida de sourcing abierta.
Errores
NOT_FOUND(404)
GET /job-posts/figures
/job-posts/figuresLos números de todas las vacantes del workspace a la vez, una fila por vacante: totales, contratados, cuántos calificados hay en cada tipo de etapa y el avance de la corrida de sourcing activa.
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/figures" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"totals": { "applications": 48, "qualified": 31, "disqualified": 17, "withdrawn": 2 },
"hired": 0,
"occupancy": { "SOURCED": 18, "SCREENING": 6, "INTERVIEW": 5, "SHORTLIST": 2, "HIRED": 0 },
"activeRun": { "found": 13, "target": 20 }
}
],
"total": 14,
"page": 1,
"pageSize": 50
}Postulaciones de la vacante
Cómo listar y sumar candidatos al embudo de una vacante. Todo lo que se hace sobre una postulación ya creada (moverla, descartarla, comentarla, evaluarla) está en ATS.
GET /job-posts/{jobPostId}/applications
/job-posts/{jobPostId}/applicationsLista las postulaciones de la vacante, de la más nueva a la más vieja, con nombre, etapa, estado, origen, match score y etiquetas. Los filtros se aplican antes de paginar, así que total cuenta lo que pasó el filtro.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| stageId | string (uuid) | Opcional | Solo las que están en esa etapa. |
| status | QUALIFIED | DISQUALIFIED | WITHDRAWN | Opcional | Filtra por estado. |
| origin | SOURCED | MANUAL | CAREER_SITE | Opcional | Filtra por cómo entró. |
| labels | string | Opcional | Nombres de etiqueta separados por coma; la postulación tiene que tener todas. Sin distinguir mayúsculas ni acentos. |
| minScore | number | Opcional | Match score mínimo (0 a 100). Solo cuenta un score vigente y con cobertura suficiente. |
| search | string | Opcional | Busca en el nombre de la persona. |
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/applications?status=QUALIFIED&minScore=60&labels=Remoto,Urgente" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
"profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
"name": "Martín Ruiz",
"stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
"status": "QUALIFIED",
"origin": "SOURCED",
"appliedAt": "2026-10-02T14:21:07.000+00:00",
"score": { "scorePct": 78, "coveragePct": 92, "isCurrent": true },
"labels": ["Remoto", "Urgente"]
}
],
"total": 1,
"page": 1,
"pageSize": 50,
"unmatchedLabels": []
}Además de la página, la respuesta trae unmatchedLabels: las etiquetas pedidas que no existen en el workspace. Si hay alguna, la lista vuelve vacía. score es null para quien nunca se midió.
Errores
NOT_FOUND(404): la vacante no existe en tu workspace.
POST /job-posts/{jobPostId}/applications
/job-posts/{jobPostId}/applicationsSuma a una persona del pool de talento al embudo, a mano. Entra en la primera etapa, como QUALIFIED, con origen MANUAL y sin match score. Devuelve la postulación creada.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | string (uuid) | Sí | Id del perfil en el pool. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/applications" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"profileId":"c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e"}'Respuesta
{
"id": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
"profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"stageId": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
"origin": "MANUAL",
"status": "QUALIFIED",
"disqualifiedReason": null,
"disqualifiedComment": null,
"resumeUrl": null,
"appliedAt": "2026-10-05T09:30:00.000+00:00"
}Errores
NOT_FOUND(404): la vacante o el perfil no existen en tu workspace.ALREADY_IN_PIPELINE(409): la persona ya está en esta vacante.DO_NOT_CONTACT(409): la persona está marcada como «no contactar» en tu workspace.JOB_POST_DRAFT(409): la vacante es un borrador y no recibe candidatos;missinglista lo que le falta para publicarse.
Acción equivalente: add_to_job_post.
POST /job-posts/{jobPostId}/applications/batch
/job-posts/{jobPostId}/applications/batchSuma a varias personas a la vez, en una sola escritura. Entran como en el alta manual. Devuelve cuántas entraron, cuántas ya estaban, cuántas no se reconocen y cuántas están bloqueadas por «no contactar».
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | string[] (uuid) | Sí | De 1 a 200 ids de perfil. Los repetidos se cuentan una vez. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/applications/batch" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"profileIds":["c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e","a4c6e8f0-2b4d-4a6c-88f0-f2b4d6a8c0e2"]}'Respuesta
{
"added": 1,
"already": 1,
"unknown": 0,
"blocked": 0,
"applicationIds": ["f3b5d7e9-1a3c-4f5b-a7e9-e1a3c5f7b9d1"]
}unknown son perfiles que tu workspace no ve; applicationIds son las postulaciones recién creadas, listas para calcularles el match score.
Errores
NOT_FOUND(404): la vacante no existe en tu workspace.JOB_POST_DRAFT(409): la vacante es un borrador y no recibe candidatos;missinglista lo que le falta para publicarse.
Acción equivalente: add_to_job_post.
POST /job-posts/{jobPostId}/applications/linkedin
/job-posts/{jobPostId}/applications/linkedinSuma a una persona a partir de la URL de su perfil de LinkedIn. Si el perfil ya está en tu pool, se reusa sin costo; si no, se trae del proveedor de datos y consume créditos. Requiere asiento. Devuelve la postulación, si hubo que traer el perfil (enriched) y los créditos usados.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| url | string | Sí | URL del perfil de LinkedIn, de 3 a 500 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/applications/linkedin" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/in/martin-ruiz-example"}'Respuesta
{
"application": {
"id": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
"profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"stageId": "e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c",
"origin": "MANUAL",
"status": "QUALIFIED",
"disqualifiedReason": null,
"disqualifiedComment": null,
"resumeUrl": null,
"appliedAt": "2026-10-05T09:30:00.000+00:00"
},
"enriched": true,
"credits": 1
}Errores
INVALID_URL(400): la URL no es de un perfil de LinkedIn.PROFILE_NOT_FOUND(404): el proveedor no encontró ese perfil.ALREADY_IN_PIPELINE(409)DO_NOT_CONTACT(409)JOB_POST_DRAFT(409): la vacante es un borrador y no recibe candidatos;missinglista lo que le falta para publicarse.NO_CREDITS(402): no quedan créditos para traer el perfil. Ver Créditos y uso.
Acción equivalente: add_to_job_post.
Etapas del embudo
Cada vacante tiene su embudo, de 3 a 12 etapas. Las dos primeras (sourcing y screening) y las dos últimas (shortlist y contratación) están fijas (isLocked): no se renombran ni se borran. Una etapa con name: null usa el nombre de su plantilla (templateKey: SOURCED, SCREENING, INTERVIEW, SHORTLIST o HIRED), que cada pantalla traduce al idioma de quien la mira.
GET /job-posts/{jobPostId}/pipeline
/job-posts/{jobPostId}/pipelineDevuelve el tablero completo de la vacante: las etapas con sus contadores y todos los candidatos, en cualquier estado (los descartados también), con su score, etiquetas, último feedback, screening, entrevistas y, si hubo contratación, las condiciones firmadas.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/pipeline" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"stages": [
{
"id": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
"name": "Entrevista técnica",
"templateKey": "INTERVIEW",
"position": 2,
"isLocked": false,
"qualified": 5,
"disqualified": 2,
"withdrawn": 0
}
],
"candidates": [
{
"applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
"profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
"stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
"status": "QUALIFIED",
"origin": "SOURCED",
"disqualifiedReason": null,
"name": "Martín Ruiz",
"headline": "Backend Engineer · Go, PostgreSQL",
"companyName": "Logística Sur",
"location": "Madrid, España",
"avatarUrl": null,
"linkedinUrl": "https://www.linkedin.com/in/martin-ruiz-example",
"appliedAt": "2026-10-02T14:21:07.000+00:00",
"stageEnteredAt": "2026-10-09T10:00:00.000+00:00",
"evaluation": { "scored": 1, "total": 2 },
"hasReport": false,
"sourceRunId": "b5d7f9a1-3c5e-4b7d-99a1-a3c5e7b9d1f3",
"placement": null,
"score": { "scorePct": 78, "coveragePct": 92, "verdict": "QUALIFIED", "isCurrent": true },
"labels": [
{
"id": "2e4a6c8e-0b2d-4f6a-8c0e-2b4d6f8a0c2e",
"name": "Remoto",
"color": "teal",
"systemKey": null
}
],
"feedback": {
"sentiment": "GOOD",
"stageId": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
"authorName": "Lucía Gómez",
"createdAt": "2026-10-10T15:02:44.000+00:00"
},
"screeningVerdict": "PASSED",
"screeningQuestionCount": 2,
"interviews": {
"held": 1,
"next": { "name": null, "scheduledAt": "2026-10-24T15:00:00.000+00:00" }
}
}
],
"activeRun": {
"longlistId": "b5d7f9a1-3c5e-4b7d-99a1-a3c5e7b9d1f3",
"targetSize": 20,
"qualified": 13
},
"openGuaranteePlacementId": null
}avatarUrl es una URL firmada de vida corta. screeningVerdict es NOT_SCREENED, FAILED, NEEDS_REVIEW o PASSED. openGuaranteePlacementId es la colocación cuya garantía activada reemplaza la próxima contratación, o null.
Errores
NOT_FOUND(404)
PUT /job-posts/{jobPostId}/pipeline
/job-posts/{jobPostId}/pipelineReemplaza el embudo entero con la lista que mandas: el orden del array es el orden de las etapas. Una etapa con id se conserva (y se renombra si mandas name), una sin id es nueva y una que no mandas se borra. Devuelve las etapas resultantes.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| stages | object[] | Sí | De 3 a 12 etapas, en orden. |
| stages[].id | string (uuid) | null | Opcional | Id de una etapa existente. Sin id, es una etapa nueva. |
| stages[].name | string | null | Opcional | Nombre, de 1 a 80 caracteres. null vuelve al nombre de plantilla. Obligatorio en una etapa nueva. |
curl -X PUT "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/pipeline" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"stages":[{"id":"e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c","name":null},{"id":"a8c0e2f4-6b8d-4a0c-92e4-f6b8d0a2c4e6","name":null},{"id":"f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b","name":"Entrevista técnica"},{"name":"Entrevista con el cliente"},{"id":"c0e2a4b6-8d0f-4c2e-b4a6-b8d0f2c4e6a8","name":null},{"id":"d1f3b5c7-9e1a-4d3f-85b7-c9e1a3d5f7b9","name":null}]}'Respuesta (extracto)
[
{
"id": "f2a4c6e8-1b3d-4f5a-9c7e-2d4f6a8c0e1b",
"name": "Entrevista técnica",
"templateKey": "INTERVIEW",
"position": 2,
"isLocked": false
},
{
"id": "e1a3c5d7-f9b1-4e3a-95c7-d9f1b3e5a7c9",
"name": "Entrevista con el cliente",
"templateKey": "INTERVIEW",
"position": 3,
"isLocked": false
}
]Errores
INVALID(400): también al renombrar o quitar una etapa fija, o al no respetar las posiciones fijas.STAGE_IN_USE(409): quitaste una etapa que tiene candidatos.STAGE_HAS_HISTORY(409): quitaste una etapa con historia (candidatos que pasaron por ella).
Acción equivalente: set_pipeline_stages.
Criterios de sourcing
Los criterios de sourcing son contra lo que se mide cada perfil para calcular su match score. El orden es el peso: el primero vale tres veces lo que vale el último (weightPct lo calcula el servidor), y un criterio required es excluyente. Una vacante tiene hasta 10.
GET /job-posts/{jobPostId}/criteria
/job-posts/{jobPostId}/criteriaLista los criterios de sourcing vigentes, en orden de importancia.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/criteria" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
[
{
"id": "a3b5c7d9-e1f3-4a5b-87c9-d1e3f5a7b9c1",
"title": "5+ años con Go",
"description": "Experiencia profesional declarada con Go",
"position": 1,
"required": true,
"weightPct": 75
},
{
"id": "b4c6d8e0-f2a4-4b6c-98d0-e2f4a6b8c0d2",
"title": "Experiencia con PostgreSQL",
"description": null,
"position": 2,
"required": false,
"weightPct": 25
}
]PUT /job-posts/{jobPostId}/criteria
/job-posts/{jobPostId}/criteriaReemplaza la lista entera de criterios, y opcionalmente el umbral, en una sola escritura. Un criterio con id se conserva con sus scores; uno sin id es nuevo; uno que no mandas se desactiva (sus scores históricos quedan). Cambiar los criterios deja desactualizados los match scores calculados. Devuelve la lista resultante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| criteria | object[] | Sí | Hasta 10, en orden de importancia. |
| criteria[].id | string (uuid) | Opcional | Id de un criterio existente. Sin id, es nuevo. |
| criteria[].title | string | Sí | De 1 a 200 caracteres. |
| criteria[].description | string | null | Opcional | Qué cuenta como cumplirlo. |
| criteria[].required | boolean | Opcional | Si es excluyente. Por defecto false. |
| thresholdPct | number | Opcional | Umbral del match score, de 0 a 100. Si no lo mandas, queda el actual. Moverlo no desactualiza los scores ya calculados. |
curl -X PUT "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/criteria" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"criteria":[{"id":"a3b5c7d9-e1f3-4a5b-87c9-d1e3f5a7b9c1","title":"5+ años con Go","description":"Experiencia profesional declarada con Go","required":true},{"title":"Experiencia con PostgreSQL","required":false}],"thresholdPct":60}'Respuesta
[
{
"id": "a3b5c7d9-e1f3-4a5b-87c9-d1e3f5a7b9c1",
"title": "5+ años con Go",
"description": "Experiencia profesional declarada con Go",
"position": 1,
"required": true,
"weightPct": 75
},
{
"id": "b4c6d8e0-f2a4-4b6c-98d0-e2f4a6b8c0d2",
"title": "Experiencia con PostgreSQL",
"description": null,
"position": 2,
"required": false,
"weightPct": 25
}
]Errores
NOT_FOUND(404): la vacante no existe, o mandaste el id de un criterio que ya no está (por ejemplo, porque otra persona lo quitó).TOO_MANY_CRITERIA(400): más de 10 criterios.CRITERIA_FROZEN(409): hay una corrida de sourcing abierta que mide con estos criterios; espera a que cierre o cancélala.
Acción equivalente: write_sourcing_criteria.
POST /job-posts/{jobPostId}/criteria/propose
/job-posts/{jobPostId}/criteria/proposeLa IA lee la vacante y propone criterios de sourcing. No guarda nada: muéstralos, que una persona los edite, y guárdalos con PUT …/criteria. También puedes saltarte este paso y escribir tus propios criterios.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| count | integer | Opcional | Cuántos criterios proponer. Por defecto 5; una vacante guarda hasta 10. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/criteria/propose?count=5" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f"Respuesta
{
"criteria": [
{
"title": "5+ años con Go",
"description": "Experiencia profesional declarada con Go",
"required": true
},
{ "title": "Experiencia con PostgreSQL", "description": null, "required": false }
],
"tokens": 1320,
"promptTokens": 980,
"completionTokens": 340
}Errores
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: write_sourcing_criteria.
GET /job-posts/{jobPostId}/criteria/breakdown
/job-posts/{jobPostId}/criteria/breakdownCómo le fue a cada criterio sobre todos los perfiles puntuados de la vacante: cuántos cumplen bien, cumplen, no cumplen o no tienen datos. Sirve para ver por qué califica poca gente: un criterio con casi todo noData está pidiendo algo que los perfiles no dicen.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/criteria/breakdown" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"scored": 120,
"qualified": 18,
"disqualified": 64,
"belowThreshold": 38,
"criteria": [
{
"title": "5+ años con Go",
"weightPct": 75,
"required": true,
"goodFit": 22,
"fit": 15,
"badFit": 61,
"noData": 22,
"total": 120
},
{
"title": "Experiencia con PostgreSQL",
"weightPct": 25,
"required": false,
"goodFit": 48,
"fit": 20,
"badFit": 9,
"noData": 43,
"total": 120
}
]
}Match score
El match score mide a un candidato contra los criterios de sourcing: un porcentaje (scorePct), qué parte del peso tuvo evidencia (coveragePct) y un veredicto (QUALIFIED, BELOW_THRESHOLD o DISQUALIFIED). Un score deja de estar vigente (isCurrent: false) cuando cambian los criterios.
GET /job-posts/{jobPostId}/match-score
/job-posts/{jobPostId}/match-scoreDice cuántas postulaciones tomaría un cálculo, sin calcular nada. Responde los mismos errores que el POST.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationIds | string | Opcional | Ids de postulación separados por coma. Sin este parámetro cuenta el alcance por defecto: los QUALIFIED sin score o con score desactualizado. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/match-score?applicationIds=5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e,f3b5d7e9-1a3c-4f5b-a7e9-e1a3c5f7b9d1" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{ "count": 2 }Errores
NOT_RESCORABLE(409): alguna de las postulaciones nombradas no es de esta vacante o está retirada.
POST /job-posts/{jobPostId}/match-score
/job-posts/{jobPostId}/match-scoreCalcula el match score de los candidatos pedidos, en cualquier etapa: los que nombras o un alcance (etapas, estado, solo pendientes). Sin body, calcula a todos los QUALIFIED sin score o con score desactualizado. Cada cálculo usa IA y consume uso del plan; requiere asiento. Si el uso se agota a mitad de camino, lo que falta queda en remaining.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| applicationIds | string[] (uuid) | Opcional | Hasta 200 postulaciones a calcular, exactamente esas. Si alguna no es de esta vacante (o está retirada), la llamada se rechaza con NOT_RESCORABLE. |
| profile | DEFAULT | OWN | PUBLIC | Opcional | Qué versión del perfil leer: OWN, la que editó tu workspace; PUBLIC, la pública; DEFAULT (o sin mandar), la propia si existe y si no la pública. |
| qualifiedOnly | boolean | Opcional | Sin applicationIds: solo candidatos QUALIFIED (por defecto) o, con false, también los descartados. |
| stageIds | string[] (uuid) | Opcional | Sin applicationIds: solo las etapas nombradas, hasta 50. |
| pendingOnly | boolean | Opcional | Sin applicationIds: solo quienes todavía no tienen score. Si no, los que no tienen score o lo tienen desactualizado. |
| cause | REGENERATE | NEW_CV | Opcional | Por qué se recalculan las postulaciones nombradas. Por defecto REGENERATE. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/match-score" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"stageIds":["e7f1a3c5-9b2d-4e6f-8a1c-3d5e7f9a1b2c","a8c0e2f4-6b8d-4a0c-92e4-f6b8d0a2c4e6"],"pendingOnly":true}'Respuesta
{
"scored": 11,
"skipped": 1,
"failed": 0,
"remaining": 0,
"unscorable": [
{
"applicationId": "f3b5d7e9-1a3c-4f5b-a7e9-e1a3c5f7b9d1",
"profileId": "a4c6e8f0-2b4d-4a6c-88f0-f2b4d6a8c0e2"
}
]
}skipped y unscorable son candidatos sin nada para leer (sin CV ni perfil pago): enriquecer el perfil les da con qué medirse.
Errores
NOTHING_TO_SCORE(409): el alcance no tiene a nadie para calcular.NOT_RESCORABLE(409): alguna de las postulaciones nombradas no es de esta vacante o está retirada.NO_CRITERIA(409): la vacante no tiene criterios de sourcing.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: run_match_score.
GET /job-posts/{jobPostId}/match-scores
/job-posts/{jobPostId}/match-scoresLista todos los match scores de la vacante, califiquen o no, con el detalle por criterio. A diferencia de la longlist (lo que se seleccionó), acá está todo lo medido.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| verdict | QUALIFIED | BELOW_THRESHOLD | DISQUALIFIED | Opcional | Filtra por veredicto. |
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/match-scores?verdict=QUALIFIED" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "e2a4c6d8-0f2b-4e4a-96c8-d0f2b4e6a8c0",
"profileId": "c4e8a2b1-6d3f-4a9c-8b7e-1f2a3b4c5d6e",
"scorePct": 78,
"coveragePct": 92,
"verdict": "QUALIFIED",
"thresholdPct": 60,
"summary": "Siete años con Go y experiencia liderando migraciones.",
"criteria": [
{
"criterionId": "a3b5c7d9-e1f3-4a5b-87c9-d1e3f5a7b9c1",
"title": "5+ años con Go",
"value": "GOOD_FIT",
"reason": "Declara 7 años con Go en dos empresas.",
"evidence": "Backend Engineer en Logística Sur (2021–hoy): servicios en Go…",
"weightPct": 75,
"required": true
}
]
}
],
"total": 1,
"page": 1,
"pageSize": 50
}criteria[].value es GOOD_FIT, FIT, BAD_FIT o NO_DATA. criterionId es null si el criterio se quitó después.
GET /job-posts/{jobPostId}/score-states
/job-posts/{jobPostId}/score-statesPor qué cada postulación tiene el score que tiene, o ninguno: su CV todavía se está leyendo, el cálculo está en cola o esperando uso, ya está calculado, no hay nada para medir o falló.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/score-states" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"applicationId": "5b0d3c8e-2f4a-4c1b-9e7d-8a6f1c2b3d4e",
"state": "SCORED",
"hasNewerCv": false,
"taskError": null
}
],
"total": 1,
"page": 1,
"pageSize": 50
}state es uno de CV_PENDING, CV_PENDING_USAGE, PENDING_USAGE, QUEUED, SCORED, CV_FAILED, NO_DATA, FAILED o NOT_REQUESTED. hasNewerCv indica que la persona mandó un CV después del score que se muestra.
GET /job-posts/{jobPostId}/rescorable
/job-posts/{jobPostId}/rescorableLos candidatos que se pueden recalcular después de un cambio de criterios: los QUALIFIED que siguen en la primera etapa y no tienen score o lo tienen desactualizado. Quien ya avanzó fue juzgado por una persona y no se ofrece. Apoyo de pantalla.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/rescorable" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"applicationId": "f3b5d7e9-1a3c-4f5b-a7e9-e1a3c5f7b9d1",
"profileId": "a4c6e8f0-2b4d-4a6c-88f0-f2b4d6a8c0e2",
"name": "Ana Torres",
"scorePct": 64,
"evaluatedAt": "2026-10-01T08:15:00.000+00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}Errores
NOT_FOUND(404)
Criterios de evaluación
Los criterios de evaluación son lo que las entrevistas buscan averiguar; el scorecard de cada candidato se arma con ellos. Cada uno tiene un peso (HIGH, MEDIUM o LOW) y ninguno es excluyente. Una vacante tiene hasta 30.
GET /job-posts/{jobPostId}/evaluation-criteria
/job-posts/{jobPostId}/evaluation-criteriaLista los criterios de evaluación, en orden.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/evaluation-criteria" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
[
{
"id": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
"name": "Diseño de APIs",
"description": "Versionado, errores y contratos estables",
"weightLevel": "HIGH",
"position": 0
},
{
"id": "c5d7e9f1-a3b5-4c7d-a9e1-f3a5b7c9d1e3",
"name": "Liderazgo técnico",
"description": null,
"weightLevel": "MEDIUM",
"position": 1
}
]POST /job-posts/{jobPostId}/evaluation-criteria
/job-posts/{jobPostId}/evaluation-criteriaAgrega un criterio al final sin tocar los demás ni sus notas. Devuelve la lista completa.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | De 1 a 200 caracteres. |
| description | string | null | Opcional | Hasta 2000 caracteres. |
| weightLevel | HIGH | MEDIUM | LOW | Opcional | Por defecto MEDIUM. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/evaluation-criteria" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"name":"Comunicación con negocio","weightLevel":"LOW"}'Respuesta (extracto)
[
{
"id": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
"name": "Diseño de APIs",
"description": "Versionado, errores y contratos estables",
"weightLevel": "HIGH",
"position": 0
},
{
"id": "c5d7e9f1-a3b5-4c7d-a9e1-f3a5b7c9d1e3",
"name": "Liderazgo técnico",
"description": null,
"weightLevel": "MEDIUM",
"position": 1
},
{
"id": "e3f5a7b9-c1d3-4e5f-a7b9-c1d3e5f7a9b1",
"name": "Comunicación con negocio",
"description": null,
"weightLevel": "LOW",
"position": 2
}
]Errores
INVALID(400): también si la vacante ya tiene 30 criterios.
PUT /job-posts/{jobPostId}/evaluation-criteria
/job-posts/{jobPostId}/evaluation-criteriaReemplaza la lista entera. Un criterio con id conserva sus notas; uno que no mandas se archiva y sus notas dejan de aparecer. Devuelve la lista resultante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| criteria | object[] | Sí | Hasta 30, en orden. |
| criteria[].id | string (uuid) | null | Opcional | Id de un criterio existente. Sin id, es nuevo. |
| criteria[].name | string | Sí | De 1 a 200 caracteres. |
| criteria[].description | string | null | Opcional | Hasta 2000 caracteres. |
| criteria[].weightLevel | HIGH | MEDIUM | LOW | Opcional | Por defecto MEDIUM. |
curl -X PUT "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/evaluation-criteria" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"criteria":[{"id":"6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c","name":"Diseño de APIs","weightLevel":"HIGH"},{"id":"c5d7e9f1-a3b5-4c7d-a9e1-f3a5b7c9d1e3","name":"Liderazgo técnico","weightLevel":"MEDIUM"}]}'Respuesta
[
{
"id": "6d8f0b2c-4e6a-4d8f-a0b2-4e6a8d0f2b4c",
"name": "Diseño de APIs",
"description": "Versionado, errores y contratos estables",
"weightLevel": "HIGH",
"position": 0
},
{
"id": "c5d7e9f1-a3b5-4c7d-a9e1-f3a5b7c9d1e3",
"name": "Liderazgo técnico",
"description": null,
"weightLevel": "MEDIUM",
"position": 1
}
]Acción equivalente: write_evaluation_criteria.
POST /job-posts/{jobPostId}/evaluation-criteria/propose
/job-posts/{jobPostId}/evaluation-criteria/proposeLa IA lee la vacante (y sus criterios de sourcing, para no volver a preguntar lo que el perfil ya contesta) y propone criterios de evaluación. No guarda nada: guárdalos con PUT …/evaluation-criteria.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/evaluation-criteria/propose" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f"Respuesta
{
"criteria": [
{
"name": "Diseño de APIs",
"description": "Versionado, errores y contratos estables",
"weightLevel": "HIGH"
},
{
"name": "Liderazgo técnico",
"description": "Cómo acompaña y revisa el trabajo de otros",
"weightLevel": "MEDIUM"
}
],
"tokens": 1104
}Errores
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: write_evaluation_criteria.
Preguntas de screening
Las preguntas de screening las contesta cada candidato sobre sí mismo al postularse, antes de que alguien lea su perfil. Una pregunta excluyente (isKnockout) termina la postulación si la respuesta no es la esperada. Una vacante tiene hasta 20. Tipos: BOOLEAN, NUMBER, RANGE, SINGLE_SELECT, MULTI_SELECT y TEXT.
GET /job-posts/{jobPostId}/screening-questions
/job-posts/{jobPostId}/screening-questionsLista las preguntas de screening, en orden.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/screening-questions" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
[
{
"id": "9a1c3e5f-7b9d-4a1c-a3e5-7b9d1a3c5e7f",
"position": 0,
"type": "BOOLEAN",
"prompt": "¿Tienes permiso de trabajo en España?",
"helpText": null,
"isKnockout": true,
"isRequired": true,
"source": "RECRUITER",
"expectedBoolean": true,
"numberOperator": null,
"numberValue": null,
"options": [],
"validOptions": [],
"requiredMatches": null
},
{
"id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"position": 1,
"type": "NUMBER",
"prompt": "¿Cuántos años de experiencia tienes con Go?",
"helpText": null,
"isKnockout": false,
"isRequired": true,
"source": "AI_GENERATED",
"expectedBoolean": null,
"numberOperator": "GTE",
"numberValue": 5,
"options": [],
"validOptions": [],
"requiredMatches": null
}
]source es RECRUITER, AI_GENERATED o AI_EDITED. Los campos de respuesta esperada que no aplican al tipo vienen en null o vacíos.
PUT /job-posts/{jobPostId}/screening-questions
/job-posts/{jobPostId}/screening-questionsReemplaza la lista entera de preguntas. Una pregunta con id se edita sin tocar las respuestas ya dadas; una sin id es nueva. Devuelve la lista resultante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| questions | object[] | Sí | Hasta 20, en orden. |
| questions[].id | string (uuid) | null | Opcional | Id de una pregunta existente. |
| questions[].type | enum | Sí | BOOLEAN, NUMBER, RANGE, SINGLE_SELECT, MULTI_SELECT o TEXT. Define qué otros campos van. |
| questions[].prompt | string | Sí | La pregunta, de 1 a 500 caracteres. |
| questions[].helpText | string | null | Opcional | Aclaración, hasta 1000 caracteres. |
| questions[].isKnockout | boolean | Opcional | Si es excluyente. Por defecto false. |
| questions[].isRequired | boolean | Opcional | Si hay que contestarla. Una excluyente es obligatoria siempre. Por defecto false. |
| questions[].source | RECRUITER | AI_GENERATED | AI_EDITED | Opcional | Quién la escribió; solo se lee al crearla. Por defecto RECRUITER. |
| questions[].expectedBoolean | boolean | Opcional | BOOLEAN: la respuesta esperada. Obligatorio. |
| questions[].numberOperator | GTE | GT | LTE | LT | EQ | Opcional | NUMBER y RANGE: cómo se compara la respuesta con numberValue. Obligatorio. |
| questions[].numberValue | number | Opcional | NUMBER y RANGE: el valor de referencia. Obligatorio. |
| questions[].options | string[] | Opcional | SINGLE_SELECT y MULTI_SELECT: de 2 a 20 opciones de hasta 120 caracteres. Obligatorio. |
| questions[].validOptions | string[] | Opcional | SINGLE_SELECT y MULTI_SELECT: las opciones que pasan; todas tienen que estar en options. Obligatorio. |
| questions[].requiredMatches | ANY | ALL | Opcional | MULTI_SELECT: si alcanza con una opción válida o hacen falta todas. Obligatorio. |
curl -X PUT "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/screening-questions" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"questions":[{"id":"9a1c3e5f-7b9d-4a1c-a3e5-7b9d1a3c5e7f","type":"BOOLEAN","prompt":"¿Tienes permiso de trabajo en España?","isKnockout":true,"expectedBoolean":true},{"type":"SINGLE_SELECT","prompt":"¿Qué modalidad prefieres?","options":["Remota","Híbrida","Presencial"],"validOptions":["Híbrida","Presencial"]}]}'Respuesta (extracto)
[
{
"id": "9a1c3e5f-7b9d-4a1c-a3e5-7b9d1a3c5e7f",
"position": 0,
"type": "BOOLEAN",
"prompt": "¿Tienes permiso de trabajo en España?",
"helpText": null,
"isKnockout": true,
"isRequired": true,
"source": "RECRUITER",
"expectedBoolean": true,
"numberOperator": null,
"numberValue": null,
"options": [],
"validOptions": [],
"requiredMatches": null
}
]POST /job-posts/{jobPostId}/screening-questions/propose
/job-posts/{jobPostId}/screening-questions/proposeLa IA lee la vacante y redacta preguntas de screening. No guarda nada: el resultado tiene el formato que acepta PUT …/screening-questions. El body es opcional.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requirements | string[] | Opcional | Los requisitos que tienes en pantalla, guardados o no (hasta 100, de hasta 500 caracteres). Si no los mandas, se usan los guardados. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/screening-questions/propose" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"requirements":["5+ años con Go","Permiso de trabajo en España"]}'Respuesta
{
"questions": [
{
"prompt": "¿Tienes permiso de trabajo en España?",
"helpText": null,
"isKnockout": true,
"isRequired": true,
"source": "AI_GENERATED",
"type": "BOOLEAN",
"expectedBoolean": true
}
],
"tokens": 1450
}Errores
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: write_screening_criteria.
Condiciones
Las condiciones son los datos que la vacante pide de cada candidato antes de una oferta: pretensión salarial, preaviso, lo que la búsqueda necesite. El valor de cada candidato se carga en ATS.
GET /job-posts/{jobPostId}/conditions
/job-posts/{jobPostId}/conditionsLista las condiciones de la vacante, en orden.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/conditions" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
[
{
"id": "7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d",
"label": "Pretensión salarial",
"hint": "Bruto anual, en EUR",
"position": 0
},
{
"id": "d6e8f0a2-b4c6-4d8e-b0f2-a4b6c8d0e2f4",
"label": "Preaviso",
"hint": null,
"position": 1
}
]PUT /job-posts/{jobPostId}/conditions
/job-posts/{jobPostId}/conditionsReemplaza la lista entera de condiciones. Una con id se actualiza en su lugar, así renombrarla no pierde lo que cada candidato ya contestó; una que no mandas se quita. Devuelve la lista resultante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| conditions | object[] | Sí | Hasta 30, en orden. |
| conditions[].id | string (uuid) | null | Opcional | Id de una condición existente. |
| conditions[].label | string | Sí | De 1 a 200 caracteres. |
| conditions[].hint | string | null | Opcional | Qué significa para quien la contesta, hasta 500 caracteres. |
curl -X PUT "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/conditions" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"conditions":[{"id":"7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d","label":"Pretensión salarial","hint":"Bruto anual, en EUR"},{"label":"Preaviso"}]}'Respuesta
[
{
"id": "7e9a1c3d-5f7b-4e9a-b1c3-5f7b9e1a3c5d",
"label": "Pretensión salarial",
"hint": "Bruto anual, en EUR",
"position": 0
},
{
"id": "d6e8f0a2-b4c6-4d8e-b0f2-a4b6c8d0e2f4",
"label": "Preaviso",
"hint": null,
"position": 1
}
]Acción equivalente: update_job_post.
Equipo
El equipo de una vacante son los miembros del workspace que trabajan en ella, además de su responsable (ownerId, que se cambia con PATCH /job-posts/{jobPostId}).
GET /job-posts/{jobPostId}/members
/job-posts/{jobPostId}/membersLista el equipo de la vacante, en el orden en que se sumaron.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/members" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "0c1e3a5b-7d9f-4c1e-83a5-7d9f1b3c5e7a",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"workspaceMemberId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}id es el id de la fila del equipo (el que pide el DELETE); workspaceMemberId es el id de membresía de la persona.
POST /job-posts/{jobPostId}/members
/job-posts/{jobPostId}/membersSuma a un miembro del workspace al equipo de la vacante. Si ya estaba, devuelve la fila existente en lugar de fallar.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| workspaceMemberId | string (uuid) | Sí | Id de membresía de la persona en el workspace. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/members" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workspaceMemberId":"f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b"}'Respuesta
{
"id": "0c1e3a5b-7d9f-4c1e-83a5-7d9f1b3c5e7a",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"workspaceMemberId": "f6b8d0e2-4a6c-4b8d-b0e2-4a6c8d0e2f4b",
"createdAt": "2026-09-28T10:00:00.000+00:00"
}Errores
INVALID(400): también si la vacante o el miembro no son de tu workspace.
Acción equivalente: add_job_post_member.
DELETE /job-posts/{jobPostId}/members/{memberId}
/job-posts/{jobPostId}/members/{memberId}Saca a una persona del equipo de la vacante. Sigue en el workspace, y sus comentarios y notas se quedan.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
| memberId | string (uuid) | Sí | El id de la fila del equipo (el campo id de GET …/members), no el id de membresía. |
curl -X DELETE "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/members/0c1e3a5b-7d9f-4c1e-83a5-7d9f1b3c5e7a" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
204 No Content, sin cuerpo.
Errores
NOT_FOUND(404)
Acción equivalente: remove_job_post_member.
Suscripciones
Quién recibe notificaciones de la vacante. origin dice por qué: OWNER (es el responsable), ADDED (alguien lo sumó) o ACTED (hizo algo en la vacante). Por esta API solo se suma con origen ADDED.
GET /job-posts/{jobPostId}/subscriptions
/job-posts/{jobPostId}/subscriptionsLista quiénes están suscritos a la vacante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/subscriptions" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "2a4c6e8b-0d2f-4a4c-86e8-b0d2f4a6c8e0",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"workspaceMemberId": "4c6e8a0b-2d4f-4c6e-a8a0-b2d4f6c8e0a2",
"origin": "ADDED",
"createdAt": "2026-10-04T13:45:00.000+00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}POST /job-posts/{jobPostId}/subscriptions
/job-posts/{jobPostId}/subscriptionsSuscribe a un miembro del workspace a la vacante. Si ya estaba suscrito por cualquier motivo, devuelve su suscripción actual.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| workspaceMemberId | string (uuid) | Sí | Id de membresía de la persona. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/subscriptions" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workspaceMemberId":"4c6e8a0b-2d4f-4c6e-a8a0-b2d4f6c8e0a2"}'Respuesta
{
"id": "2a4c6e8b-0d2f-4a4c-86e8-b0d2f4a6c8e0",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"workspaceMemberId": "4c6e8a0b-2d4f-4c6e-a8a0-b2d4f6c8e0a2",
"origin": "ADDED",
"createdAt": "2026-10-04T13:45:00.000+00:00"
}Errores
INVALID(400): también si la vacante o el miembro no son de tu workspace.
Acción equivalente: add_job_post_subscriber.
DELETE /job-posts/{jobPostId}/subscriptions/{memberId}
/job-posts/{jobPostId}/subscriptions/{memberId}Quita la suscripción de un miembro a la vacante.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
| memberId | string (uuid) | Sí | Id de membresía de la persona (workspaceMemberId), no el id de la suscripción. |
curl -X DELETE "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/subscriptions/4c6e8a0b-2d4f-4c6e-a8a0-b2d4f6c8e0a2" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
204 No Content, sin cuerpo.
Errores
NOT_FOUND(404): esa persona no está suscrita.OWNER_CANNOT_UNSUBSCRIBE(409): el responsable de la vacante no se desuscribe; deja de serlo pasándole la vacante a otra persona.
Acción equivalente: remove_job_post_subscriber.
Notas
Notas internas del equipo sobre la vacante, con un nivel de respuestas. Una nota se corrige, no se borra.
GET /job-posts/{jobPostId}/notes
/job-posts/{jobPostId}/notesLista las notas de la vacante, de la más vieja a la más nueva. Las respuestas traen parentId.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/notes" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "7a9c1e3f-5b7d-4f9a-b1c3-5d7f9a1b3c5d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"parentId": null,
"authorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
"authorName": "Lucía Gómez",
"body": "El cliente prioriza a alguien que pueda arrancar antes de diciembre.",
"createdAt": "2026-10-03T11:20:05.000+00:00",
"updatedAt": null
},
{
"id": "1f3a5c7e-9b1d-4f3a-a5c7-e9b1d3f5a7c9",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"parentId": "7a9c1e3f-5b7d-4f9a-b1c3-5d7f9a1b3c5d",
"authorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
"authorName": "Lucía Gómez",
"body": "Lo confirmé con el cliente: inicio el 1 de diciembre.",
"createdAt": "2026-10-03T15:02:11.000+00:00",
"updatedAt": null
}
],
"total": 2,
"page": 1,
"pageSize": 50
}POST /job-posts/{jobPostId}/notes
/job-posts/{jobPostId}/notesCrea una nota, o una respuesta a una nota raíz de la misma vacante. Devuelve la nota creada.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| body | string | Sí | Texto, de 1 a 5000 caracteres. |
| parentId | string (uuid) | null | Opcional | Nota a la que responde. Tiene que ser una nota raíz de esta vacante. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/notes" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"body":"El cliente prioriza a alguien que pueda arrancar antes de diciembre."}'Respuesta
{
"id": "7a9c1e3f-5b7d-4f9a-b1c3-5d7f9a1b3c5d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"parentId": null,
"authorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
"authorName": "Lucía Gómez",
"body": "El cliente prioriza a alguien que pueda arrancar antes de diciembre.",
"createdAt": "2026-10-03T11:20:05.000+00:00",
"updatedAt": null
}Errores
NOT_FOUND(404): la nota padre no existe.INVALID(400): también si la nota padre es de otra vacante o ya es una respuesta.
Acción equivalente: create_note.
PATCH /job-posts/{jobPostId}/notes/{noteId}
/job-posts/{jobPostId}/notes/{noteId}Corrige el texto de una nota. Solo su autor puede hacerlo. Devuelve la nota.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
| noteId | string (uuid) | Sí | Id de la nota. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| body | string | Sí | Texto nuevo, de 1 a 5000 caracteres. |
curl -X PATCH "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/notes/7a9c1e3f-5b7d-4f9a-b1c3-5d7f9a1b3c5d" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"El cliente prioriza a alguien que pueda arrancar antes del 1 de diciembre."}'Respuesta
{
"id": "7a9c1e3f-5b7d-4f9a-b1c3-5d7f9a1b3c5d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"parentId": null,
"authorId": "a1c3e5f7-9b1d-4c3e-85f7-9b1d3e5f7a9c",
"authorName": "Lucía Gómez",
"body": "El cliente prioriza a alguien que pueda arrancar antes del 1 de diciembre.",
"createdAt": "2026-10-03T11:20:05.000+00:00",
"updatedAt": "2026-10-04T09:10:00.000+00:00"
}Errores
NOT_FOUND(404): la nota no existe o no es tuya.
Acción equivalente: update_note.
DELETE /job-posts/{jobPostId}/notes/{noteId}
/job-posts/{jobPostId}/notes/{noteId}Una nota no se borra: se corrige.
Una API key no borra este recurso: el DELETE contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_note" }]. Usa en su lugar update_note.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
| noteId | string (uuid) | Sí | Id de la nota. |
curl -X DELETE "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/notes/7a9c1e3f-5b7d-4f9a-b1c3-5d7f9a1b3c5d" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (405)
{
"error": "DELETE_NOT_ALLOWED",
"allowed": ["PATCH"],
"suggestions": [{ "tool": "update_note" }]
}Links compartidos
Un link compartido abre la vacante a alguien sin cuenta, normalmente el cliente. Hay dos alcances: SHORTLIST, la shortlist que se presenta al cliente (https://app.reclee.com/public-shortlist/<token>, uno vivo por vacante), y FULL, el embudo completo (https://app.reclee.com/share/<token>, puede haber varios). Revocar un link lo desactiva para siempre; la fila queda como registro de quién tuvo acceso y hasta cuándo.
GET /job-posts/{jobPostId}/shares
/job-posts/{jobPostId}/sharesLista todos los links que la vacante entregó, revocados incluidos, del más nuevo al más viejo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Por defecto 1. |
| pageSize | integer | Opcional | De 1 a 200. Por defecto 50. |
Pagina: ver Paginación.
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/shares" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"rows": [
{
"id": "8b0d2f4a-6c8e-4a0b-92d4-6f8a0c2e4b6d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"token": "q3Zr8Xk1Vb6sT0wLmN4pYc7dHf2jA9eUgK5iO1nB8xE",
"scope": "SHORTLIST",
"label": "Shortlist para Pagos Atlas",
"active": true,
"showContact": false,
"expiresAt": "2026-11-30T23:59:59.999+00:00",
"lastViewedAt": null,
"createdAt": "2026-10-16T12:30:00.000+00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}active es false en un link revocado. lastViewedAt es la última vez que alguien lo abrió.
POST /job-posts/{jobPostId}/shares
/job-posts/{jobPostId}/sharesCrea un link. El token lo genera el servidor. Por defecto es una shortlist sin datos de contacto. Devuelve el link creado, con su token.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| scope | SHORTLIST | FULL | Opcional | Qué abre el link. Por defecto SHORTLIST. |
| label | string | null | Opcional | Para quién es, de 1 a 120 caracteres. |
| showContact | boolean | Opcional | Si muestra el email y el teléfono de los candidatos. Por defecto false. |
| expiresAt | string | null | Opcional | Vencimiento: una fecha AAAA-MM-DD (vence al final de ese día, en UTC) o un instante ISO 8601. Tiene que ser futuro. Sin mandar, no vence. |
curl -X POST "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/shares" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Idempotency-Key: 6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f" \
-H "Content-Type: application/json" \
-d '{"scope":"SHORTLIST","label":"Shortlist para Pagos Atlas","expiresAt":"2026-11-30"}'Respuesta
{
"id": "8b0d2f4a-6c8e-4a0b-92d4-6f8a0c2e4b6d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"token": "q3Zr8Xk1Vb6sT0wLmN4pYc7dHf2jA9eUgK5iO1nB8xE",
"scope": "SHORTLIST",
"label": "Shortlist para Pagos Atlas",
"active": true,
"showContact": false,
"expiresAt": "2026-11-30T23:59:59.999+00:00",
"lastViewedAt": null,
"createdAt": "2026-10-16T12:30:00.000+00:00"
}Errores
SHORTLIST_LINK_ACTIVE(409): la vacante ya tiene un link SHORTLIST vivo; revócalo antes de crear otro.INVALID(400): también con una fecha de vencimiento pasada.
Acción equivalente: create_job_post_share.
PATCH /job-posts/{jobPostId}/shares/{shareId}
/job-posts/{jobPostId}/shares/{shareId}Cambia lo que se puede cambiar en un link vivo: el vencimiento y si muestra los datos de contacto. El token no cambia, así que quien tiene la URL ve el cambio al recargar. Devuelve el link.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
| shareId | string (uuid) | Sí | Id del link. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| showContact | boolean | Opcional | Si muestra el email y el teléfono de los candidatos. |
| expiresAt | string | null | Opcional | Vencimiento: una fecha AAAA-MM-DD (vence al final de ese día, en UTC) o un instante ISO 8601. Tiene que ser futuro. null lo deja sin vencimiento. |
Manda al menos uno de los dos campos; un body vacío es INVALID.
curl -X PATCH "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/shares/8b0d2f4a-6c8e-4a0b-92d4-6f8a0c2e4b6d" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"showContact":true,"expiresAt":null}'Respuesta
{
"id": "8b0d2f4a-6c8e-4a0b-92d4-6f8a0c2e4b6d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"token": "q3Zr8Xk1Vb6sT0wLmN4pYc7dHf2jA9eUgK5iO1nB8xE",
"scope": "SHORTLIST",
"label": "Shortlist para Pagos Atlas",
"active": true,
"showContact": true,
"expiresAt": null,
"lastViewedAt": null,
"createdAt": "2026-10-16T12:30:00.000+00:00"
}Errores
NOT_FOUND(404)
DELETE /job-posts/{jobPostId}/shares/{shareId}
/job-posts/{jobPostId}/shares/{shareId}Revoca el link. No borra nada: devuelve el link desactivado (active: false). Es irreversible; un link nuevo trae un token nuevo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
| shareId | string (uuid) | Sí | Id del link. |
curl -X DELETE "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/shares/8b0d2f4a-6c8e-4a0b-92d4-6f8a0c2e4b6d" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"id": "8b0d2f4a-6c8e-4a0b-92d4-6f8a0c2e4b6d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"token": "q3Zr8Xk1Vb6sT0wLmN4pYc7dHf2jA9eUgK5iO1nB8xE",
"scope": "SHORTLIST",
"label": "Shortlist para Pagos Atlas",
"active": false,
"showContact": false,
"expiresAt": "2026-11-30T23:59:59.999+00:00",
"lastViewedAt": null,
"createdAt": "2026-10-16T12:30:00.000+00:00"
}Errores
NOT_FOUND(404)
Acción equivalente: revoke_job_post_share.
GET /job-posts/{jobPostId}/shares/presentation
/job-posts/{jobPostId}/shares/presentationLos links de la vacante, revocados incluidos, y presentedAt: cuándo se generó el primer link de shortlist, es decir, cuándo se presentó la vacante al cliente. Revocar y crear otro no mueve esa fecha.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante. |
curl "https://app.reclee.com/api/v1/job-posts/9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90/shares/presentation" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"shares": [
{
"id": "8b0d2f4a-6c8e-4a0b-92d4-6f8a0c2e4b6d",
"jobPostId": "9a2e4f61-7c3b-4d8e-a1f0-2b5c6d7e8f90",
"token": "q3Zr8Xk1Vb6sT0wLmN4pYc7dHf2jA9eUgK5iO1nB8xE",
"scope": "SHORTLIST",
"label": "Shortlist para Pagos Atlas",
"active": true,
"showContact": false,
"expiresAt": "2026-11-30T23:59:59.999+00:00",
"lastViewedAt": null,
"createdAt": "2026-10-16T12:30:00.000+00:00"
}
],
"presentedAt": "2026-10-16T12:30:00.000+00:00"
}presentedAt es null si la vacante nunca entregó un link de shortlist.