Reclee

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

GET/job-posts

Lista 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

CampoTipoRequeridoDescripción
statusDRAFT | ACTIVE | CLOSEDOpcionalFiltra por estado.
pageintegerOpcionalPágina, desde 1. Por defecto 1.
pageSizeintegerOpcionalFilas 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

POST/job-posts

Crea 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

CampoTipoRequeridoDescripción
titlestringSíDe 1 a 200 caracteres.
requestIdstring (uuid) | nullOpcionalPedido del CRM que origina la vacante. Al crear, lo que no mandes se completa con los datos del pedido y su lead.
descriptionstring | nullOpcionalDescripción en HTML, hasta 50.000 caracteres. Se limpia al guardar.
seniorityenum | nullOpcionalUno de: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE.
employmentTypeenum | nullOpcionalUno de: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER.
workplaceTypeenum | nullOpcionalREMOTE, HYBRID u ON_SITE.
locationstring | nullOpcionalTexto libre, hasta 200 caracteres.
countrystring | nullOpcionalCódigo ISO 3166-1 alfa-2 (por ejemplo, ES o AR).
citystring | nullOpcionalDe 3 a 200 caracteres.
salaryMinnumber | nullOpcionalMayor o igual a 0 y no mayor que salaryMax. Un salario exige salaryPeriod y currencyCode.
salaryMaxnumber | nullOpcionalMayor o igual a 0.
currencyCodestring | nullOpcionalCódigo de moneda ISO 4217 (EUR, USD, ARS…).
salaryPeriodenum | nullOpcionalHOURLY, DAILY, MONTHLY o YEARLY.
targetStartDatestring (date) | nullOpcionalFecha de inicio buscada, AAAA-MM-DD.
openingsintegerOpcionalPosiciones a cubrir, de 1 a 500. Por defecto 1.
responsibilitiesstring[]OpcionalHasta 100 ítems de hasta 2000 caracteres. Por defecto vacío.
requirementsstring[]OpcionalRequisitos obligatorios. Mismo límite. Por defecto vacío.
niceToHavesstring[]OpcionalRequisitos deseables. Mismo límite. Por defecto vacío.
benefitsstring[]OpcionalBeneficios. Mismo límite. Por defecto vacío.
companyPitchstring | nullOpcionalPárrafo sobre la empresa, hasta 50.000 caracteres.
bonusstring | nullOpcionalHasta 2000 caracteres.
equitystring | nullOpcionalHasta 2000 caracteres.
ownerIdstring (uuid) | nullOpcionalId de membresía de quien lleva la vacante. Al crear, si no lo mandas, queda quien llama; null la deja sin responsable.
matchThresholdPctnumberOpcionalUmbral del match score para calificar, de 0 a 100. Por defecto 50.
matchScoreTriggerON_APPLY | MANUALOpcionalON_APPLY calcula el match score de cada postulación que entra (consume uso, requiere asiento); MANUAL solo cuando se pide.
recommendationThresholdnumberOpcionalNota del scorecard, de 0 a 5, desde la que se recomienda a un candidato.
draftStepintegerOpcionalPaso del asistente de creación en el que quedó un borrador (desde 1).
publishToCareerSitebooleanOpcionalSi la vacante se publica en el sitio de empleo cuando esté activa.
showSalarybooleanOpcionalSi el sitio de empleo muestra el salario.
showClientbooleanOpcionalSi el sitio de empleo muestra el cliente.
showApplicantCountbooleanOpcionalSi el sitio de empleo muestra cuántas personas se postularon.
contentLocalees | enOpcionalIdioma 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 sin salaryPeriod o sin currencyCode, o salaryMin mayor que salaryMax.
  • REQUEST_ALREADY_LINKED (409): el pedido ya respalda otra vacante.

Acción equivalente: create_job_post.

GET /job-posts/{jobPostId}

GET/job-posts/{jobPostId}

Devuelve una vacante.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (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}

PATCH/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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
titlestringOpcionalDe 1 a 200 caracteres.
requestIdstring (uuid) | nullOpcionalPedido del CRM que origina la vacante. Al crear, lo que no mandes se completa con los datos del pedido y su lead.
descriptionstring | nullOpcionalDescripción en HTML, hasta 50.000 caracteres. Se limpia al guardar.
seniorityenum | nullOpcionalUno de: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE.
employmentTypeenum | nullOpcionalUno de: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER.
workplaceTypeenum | nullOpcionalREMOTE, HYBRID u ON_SITE.
locationstring | nullOpcionalTexto libre, hasta 200 caracteres.
countrystring | nullOpcionalCódigo ISO 3166-1 alfa-2 (por ejemplo, ES o AR).
citystring | nullOpcionalDe 3 a 200 caracteres.
salaryMinnumber | nullOpcionalMayor o igual a 0 y no mayor que salaryMax. Un salario exige salaryPeriod y currencyCode.
salaryMaxnumber | nullOpcionalMayor o igual a 0.
currencyCodestring | nullOpcionalCódigo de moneda ISO 4217 (EUR, USD, ARS…).
salaryPeriodenum | nullOpcionalHOURLY, DAILY, MONTHLY o YEARLY.
targetStartDatestring (date) | nullOpcionalFecha de inicio buscada, AAAA-MM-DD.
openingsintegerOpcionalPosiciones a cubrir, de 1 a 500.
responsibilitiesstring[]OpcionalHasta 100 ítems de hasta 2000 caracteres.
requirementsstring[]OpcionalRequisitos obligatorios. Mismo límite.
niceToHavesstring[]OpcionalRequisitos deseables. Mismo límite.
benefitsstring[]OpcionalBeneficios. Mismo límite.
companyPitchstring | nullOpcionalPárrafo sobre la empresa, hasta 50.000 caracteres.
bonusstring | nullOpcionalHasta 2000 caracteres.
equitystring | nullOpcionalHasta 2000 caracteres.
ownerIdstring (uuid) | nullOpcionalId de membresía de quien lleva la vacante. Al crear, si no lo mandas, queda quien llama; null la deja sin responsable.
matchThresholdPctnumberOpcionalUmbral del match score para calificar, de 0 a 100.
matchScoreTriggerON_APPLY | MANUALOpcionalON_APPLY calcula el match score de cada postulación que entra (consume uso, requiere asiento); MANUAL solo cuando se pide.
recommendationThresholdnumberOpcionalNota del scorecard, de 0 a 5, desde la que se recomienda a un candidato.
draftStepintegerOpcionalPaso 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): activar matchScoreTrigger: "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}

DELETE/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

CampoTipoRequeridoDescripción
jobPostIdstring (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 trae suggestions: [{ "tool": "close_job_post", "input": { "jobPostId": "…" } }]: ciérrala en su lugar.

Acción equivalente: delete_draft_job_post.

PUT /job-posts/{jobPostId}/status

PUT/job-posts/{jobPostId}/status

Abre 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
statusACTIVE | CLOSEDSíEstado nuevo.
closeReasonstring | nullOpcionalPor 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; missing lista los campos: description, seniority, employmentType, workplaceType, country y city (esta solo si es HYBRID u ON_SITE).
  • CLOSE_REASON_REQUIRED (422): cerrar con posiciones sin cubrir sin closeReason; trae missing: ["closeReason"].
  • INVALID (400): también al intentar cerrar un borrador.

Acciones equivalentes: close_job_post, reopen_job_post.

GET /job-posts/{jobPostId}/context

GET/job-posts/{jobPostId}/context

Devuelve 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

CampoTipoRequeridoDescripción
jobPostIdstring (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

GET/job-posts/contexts

Lista las vacantes con su contexto (cliente, responsable) y la fecha de la última actividad, filtradas. Es la lectura del índice de vacantes.

Query

CampoTipoRequeridoDescripción
searchstringOpcionalBusca en el título, sin distinguir mayúsculas ni acentos. De 1 a 100 caracteres.
clientstringOpcionalBusca en el nombre del cliente; deja afuera las vacantes sin pedido. De 1 a 100 caracteres.
statusDRAFT | ACTIVE | CLOSEDOpcionalFiltra por estado.
ownerIdstring (uuid)OpcionalId de membresía del responsable.
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

GET/job-posts/refs

Lista las vacantes activas como referencia corta (id, título y cliente), para elegir una en un filtro o un selector.

Query

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

GET/job-posts/refs/open

Las 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

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

GET/job-posts/{jobPostId}/draft

Devuelve 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

CampoTipoRequeridoDescripción
jobPostIdstring (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

POST/job-posts/{jobPostId}/request

Vincula 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
requestIdstring (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

POST/job-posts/draft

Lee 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

CampoTipoRequeridoDescripción
textstringSí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

POST/job-posts/{jobPostId}/description

Reescribe 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
sourceTextstring | nullOpcionalEl texto original del puesto, si lo tienes. Hasta 20.000 caracteres.
previousstring | nullOpcionalLa 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.
instructionstring | nullOpcionalQué 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

POST/job-posts/{jobPostId}/content

Redacta 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
blockRESPONSIBILITIES | REQUIREMENTS | PITCHSíQué bloque redactar.
previousstring | string[] | nullOpcionalLo que hay ahora, si ya se generó una vez: un texto (hasta 20.000 caracteres) o una lista (hasta 30 ítems de 500).
instructionstring | nullOpcionalQué 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

GET/job-posts/{jobPostId}/metrics

Devuelve 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

CampoTipoRequeridoDescripción
jobPostIdstring (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

GET/job-posts/figures

Los 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

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

GET/job-posts/{jobPostId}/applications

Lista 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
stageIdstring (uuid)OpcionalSolo las que están en esa etapa.
statusQUALIFIED | DISQUALIFIED | WITHDRAWNOpcionalFiltra por estado.
originSOURCED | MANUAL | CAREER_SITEOpcionalFiltra por cómo entró.
labelsstringOpcionalNombres de etiqueta separados por coma; la postulación tiene que tener todas. Sin distinguir mayúsculas ni acentos.
minScorenumberOpcionalMatch score mínimo (0 a 100). Solo cuenta un score vigente y con cobertura suficiente.
searchstringOpcionalBusca en el nombre de la persona.
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

POST/job-posts/{jobPostId}/applications

Suma 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
profileIdstring (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; missing lista lo que le falta para publicarse.

Acción equivalente: add_to_job_post.

POST /job-posts/{jobPostId}/applications/batch

POST/job-posts/{jobPostId}/applications/batch

Suma 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
profileIdsstring[] (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; missing lista lo que le falta para publicarse.

Acción equivalente: add_to_job_post.

POST /job-posts/{jobPostId}/applications/linkedin

POST/job-posts/{jobPostId}/applications/linkedin

Suma 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
urlstringSí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; missing lista 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

GET/job-posts/{jobPostId}/pipeline

Devuelve 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

CampoTipoRequeridoDescripción
jobPostIdstring (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

PUT/job-posts/{jobPostId}/pipeline

Reemplaza 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
stagesobject[]SíDe 3 a 12 etapas, en orden.
stages[].idstring (uuid) | nullOpcionalId de una etapa existente. Sin id, es una etapa nueva.
stages[].namestring | nullOpcionalNombre, 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

GET/job-posts/{jobPostId}/criteria

Lista los criterios de sourcing vigentes, en orden de importancia.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (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

PUT/job-posts/{jobPostId}/criteria

Reemplaza 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
criteriaobject[]SíHasta 10, en orden de importancia.
criteria[].idstring (uuid)OpcionalId de un criterio existente. Sin id, es nuevo.
criteria[].titlestringSíDe 1 a 200 caracteres.
criteria[].descriptionstring | nullOpcionalQué cuenta como cumplirlo.
criteria[].requiredbooleanOpcionalSi es excluyente. Por defecto false.
thresholdPctnumberOpcionalUmbral 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

POST/job-posts/{jobPostId}/criteria/propose

La 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
countintegerOpcionalCuá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

GET/job-posts/{jobPostId}/criteria/breakdown

Có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

CampoTipoRequeridoDescripción
jobPostIdstring (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

GET/job-posts/{jobPostId}/match-score

Dice cuántas postulaciones tomaría un cálculo, sin calcular nada. Responde los mismos errores que el POST.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
applicationIdsstringOpcionalIds 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

POST/job-posts/{jobPostId}/match-score

Calcula 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
applicationIdsstring[] (uuid)OpcionalHasta 200 postulaciones a calcular, exactamente esas. Si alguna no es de esta vacante (o está retirada), la llamada se rechaza con NOT_RESCORABLE.
profileDEFAULT | OWN | PUBLICOpcionalQué 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.
qualifiedOnlybooleanOpcionalSin applicationIds: solo candidatos QUALIFIED (por defecto) o, con false, también los descartados.
stageIdsstring[] (uuid)OpcionalSin applicationIds: solo las etapas nombradas, hasta 50.
pendingOnlybooleanOpcionalSin applicationIds: solo quienes todavía no tienen score. Si no, los que no tienen score o lo tienen desactualizado.
causeREGENERATE | NEW_CVOpcionalPor 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

GET/job-posts/{jobPostId}/match-scores

Lista 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
verdictQUALIFIED | BELOW_THRESHOLD | DISQUALIFIEDOpcionalFiltra por veredicto.
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

GET/job-posts/{jobPostId}/score-states

Por 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

GET/job-posts/{jobPostId}/rescorable

Los 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

GET/job-posts/{jobPostId}/evaluation-criteria

Lista los criterios de evaluación, en orden.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (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

POST/job-posts/{jobPostId}/evaluation-criteria

Agrega un criterio al final sin tocar los demás ni sus notas. Devuelve la lista completa.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
namestringSíDe 1 a 200 caracteres.
descriptionstring | nullOpcionalHasta 2000 caracteres.
weightLevelHIGH | MEDIUM | LOWOpcionalPor 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

PUT/job-posts/{jobPostId}/evaluation-criteria

Reemplaza 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
criteriaobject[]SíHasta 30, en orden.
criteria[].idstring (uuid) | nullOpcionalId de un criterio existente. Sin id, es nuevo.
criteria[].namestringSíDe 1 a 200 caracteres.
criteria[].descriptionstring | nullOpcionalHasta 2000 caracteres.
criteria[].weightLevelHIGH | MEDIUM | LOWOpcionalPor 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

POST/job-posts/{jobPostId}/evaluation-criteria/propose

La 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

CampoTipoRequeridoDescripción
jobPostIdstring (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

GET/job-posts/{jobPostId}/screening-questions

Lista las preguntas de screening, en orden.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (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

PUT/job-posts/{jobPostId}/screening-questions

Reemplaza 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
questionsobject[]SíHasta 20, en orden.
questions[].idstring (uuid) | nullOpcionalId de una pregunta existente.
questions[].typeenumSíBOOLEAN, NUMBER, RANGE, SINGLE_SELECT, MULTI_SELECT o TEXT. Define qué otros campos van.
questions[].promptstringSíLa pregunta, de 1 a 500 caracteres.
questions[].helpTextstring | nullOpcionalAclaración, hasta 1000 caracteres.
questions[].isKnockoutbooleanOpcionalSi es excluyente. Por defecto false.
questions[].isRequiredbooleanOpcionalSi hay que contestarla. Una excluyente es obligatoria siempre. Por defecto false.
questions[].sourceRECRUITER | AI_GENERATED | AI_EDITEDOpcionalQuién la escribió; solo se lee al crearla. Por defecto RECRUITER.
questions[].expectedBooleanbooleanOpcionalBOOLEAN: la respuesta esperada. Obligatorio.
questions[].numberOperatorGTE | GT | LTE | LT | EQOpcionalNUMBER y RANGE: cómo se compara la respuesta con numberValue. Obligatorio.
questions[].numberValuenumberOpcionalNUMBER y RANGE: el valor de referencia. Obligatorio.
questions[].optionsstring[]OpcionalSINGLE_SELECT y MULTI_SELECT: de 2 a 20 opciones de hasta 120 caracteres. Obligatorio.
questions[].validOptionsstring[]OpcionalSINGLE_SELECT y MULTI_SELECT: las opciones que pasan; todas tienen que estar en options. Obligatorio.
questions[].requiredMatchesANY | ALLOpcionalMULTI_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

POST/job-posts/{jobPostId}/screening-questions/propose

La 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
requirementsstring[]OpcionalLos 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

GET/job-posts/{jobPostId}/conditions

Lista las condiciones de la vacante, en orden.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (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

PUT/job-posts/{jobPostId}/conditions

Reemplaza 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
conditionsobject[]SíHasta 30, en orden.
conditions[].idstring (uuid) | nullOpcionalId de una condición existente.
conditions[].labelstringSíDe 1 a 200 caracteres.
conditions[].hintstring | nullOpcionalQué 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

GET/job-posts/{jobPostId}/members

Lista el equipo de la vacante, en el orden en que se sumaron.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

POST/job-posts/{jobPostId}/members

Suma 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
workspaceMemberIdstring (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}

DELETE/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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.
memberIdstring (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

GET/job-posts/{jobPostId}/subscriptions

Lista quiénes están suscritos a la vacante.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

POST/job-posts/{jobPostId}/subscriptions

Suscribe a un miembro del workspace a la vacante. Si ya estaba suscrito por cualquier motivo, devuelve su suscripción actual.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
workspaceMemberIdstring (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}

DELETE/job-posts/{jobPostId}/subscriptions/{memberId}

Quita la suscripción de un miembro a la vacante.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.
memberIdstring (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

GET/job-posts/{jobPostId}/notes

Lista las notas de la vacante, de la más vieja a la más nueva. Las respuestas traen parentId.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

POST/job-posts/{jobPostId}/notes

Crea una nota, o una respuesta a una nota raíz de la misma vacante. Devuelve la nota creada.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
bodystringSíTexto, de 1 a 5000 caracteres.
parentIdstring (uuid) | nullOpcionalNota 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}

PATCH/job-posts/{jobPostId}/notes/{noteId}

Corrige el texto de una nota. Solo su autor puede hacerlo. Devuelve la nota.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.
noteIdstring (uuid)SíId de la nota.

Body

CampoTipoRequeridoDescripción
bodystringSí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}

DELETE/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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.
noteIdstring (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" }]
}

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

GET/job-posts/{jobPostId}/shares

Lista todos los links que la vacante entregó, revocados incluidos, del más nuevo al más viejo.

Parámetros de ruta

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Query

CampoTipoRequeridoDescripción
pageintegerOpcionalPor defecto 1.
pageSizeintegerOpcionalDe 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

POST/job-posts/{jobPostId}/shares

Crea 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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.

Body

CampoTipoRequeridoDescripción
scopeSHORTLIST | FULLOpcionalQué abre el link. Por defecto SHORTLIST.
labelstring | nullOpcionalPara quién es, de 1 a 120 caracteres.
showContactbooleanOpcionalSi muestra el email y el teléfono de los candidatos. Por defecto false.
expiresAtstring | nullOpcionalVencimiento: 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}

PATCH/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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.
shareIdstring (uuid)SíId del link.

Body

CampoTipoRequeridoDescripción
showContactbooleanOpcionalSi muestra el email y el teléfono de los candidatos.
expiresAtstring | nullOpcionalVencimiento: 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}

DELETE/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

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante.
shareIdstring (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

GET/job-posts/{jobPostId}/shares/presentation

Los 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

CampoTipoRequeridoDescripción
jobPostIdstring (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.

En esta página

VacantesGET /job-postsPOST /job-postsGET /job-posts/{jobPostId}PATCH /job-posts/{jobPostId}DELETE /job-posts/{jobPostId}PUT /job-posts/{jobPostId}/statusGET /job-posts/{jobPostId}/contextGET /job-posts/contextsGET /job-posts/refsGET /job-posts/refs/openGET /job-posts/{jobPostId}/draftPOST /job-posts/{jobPostId}/requestRedacción con IAPOST /job-posts/draftPOST /job-posts/{jobPostId}/descriptionPOST /job-posts/{jobPostId}/contentMétricasGET /job-posts/{jobPostId}/metricsGET /job-posts/figuresPostulaciones de la vacanteGET /job-posts/{jobPostId}/applicationsPOST /job-posts/{jobPostId}/applicationsPOST /job-posts/{jobPostId}/applications/batchPOST /job-posts/{jobPostId}/applications/linkedinEtapas del embudoGET /job-posts/{jobPostId}/pipelinePUT /job-posts/{jobPostId}/pipelineCriterios de sourcingGET /job-posts/{jobPostId}/criteriaPUT /job-posts/{jobPostId}/criteriaPOST /job-posts/{jobPostId}/criteria/proposeGET /job-posts/{jobPostId}/criteria/breakdownMatch scoreGET /job-posts/{jobPostId}/match-scorePOST /job-posts/{jobPostId}/match-scoreGET /job-posts/{jobPostId}/match-scoresGET /job-posts/{jobPostId}/score-statesGET /job-posts/{jobPostId}/rescorableCriterios de evaluaciónGET /job-posts/{jobPostId}/evaluation-criteriaPOST /job-posts/{jobPostId}/evaluation-criteriaPUT /job-posts/{jobPostId}/evaluation-criteriaPOST /job-posts/{jobPostId}/evaluation-criteria/proposePreguntas de screeningGET /job-posts/{jobPostId}/screening-questionsPUT /job-posts/{jobPostId}/screening-questionsPOST /job-posts/{jobPostId}/screening-questions/proposeCondicionesGET /job-posts/{jobPostId}/conditionsPUT /job-posts/{jobPostId}/conditionsEquipoGET /job-posts/{jobPostId}/membersPOST /job-posts/{jobPostId}/membersDELETE /job-posts/{jobPostId}/members/{memberId}SuscripcionesGET /job-posts/{jobPostId}/subscriptionsPOST /job-posts/{jobPostId}/subscriptionsDELETE /job-posts/{jobPostId}/subscriptions/{memberId}NotasGET /job-posts/{jobPostId}/notesPOST /job-posts/{jobPostId}/notesPATCH /job-posts/{jobPostId}/notes/{noteId}DELETE /job-posts/{jobPostId}/notes/{noteId}Links compartidosGET /job-posts/{jobPostId}/sharesPOST /job-posts/{jobPostId}/sharesPATCH /job-posts/{jobPostId}/shares/{shareId}DELETE /job-posts/{jobPostId}/shares/{shareId}GET /job-posts/{jobPostId}/shares/presentation