Reclee

Vacantes

Acciones para crear, editar, cerrar y configurar vacantes: equipo, pipeline, links para clientes, notas y criterios.

Estas acciones escriben sobre una vacante y su configuración. Para leer una vacante usa GET /job-posts/{jobPostId}; para la lista, GET /job-posts. Cómo se llama a una acción, la forma de la respuesta y los errores comunes están en Acciones.

Una vacante nace como borrador (DRAFT), se publica (pasa a ACTIVE) y se cierra (CLOSED). Ninguna acción la publica: se publica desde la app o con PUT /job-posts/{jobPostId}/status y {"status": "ACTIVE"}, que responde 422 PUBLISH_INCOMPLETE con missing si le falta algún campo obligatorio.

create_job_post

Familia: GENERATE · No consume créditos ni uso de IA; como toda acción GENERATE, la respuesta trae cost, que acá queda en cero.

Crea una vacante nueva como borrador (DRAFT). Escribe en el momento, sin paso de confirmación: un borrador no se publica ni recibe candidatos hasta que alguien lo publica desde la app, y esta acción no publica.

Solo title es obligatorio, pero un borrador con solo el título sirve de poco: envía todo lo que sepas (descripción, país, modalidad, salario) en lugar de completarlo después.

  • Con requestId la vacante queda vinculada a ese request del CRM, y cada campo que omitas se toma de él: openings de sus posiciones, el rango salarial con su moneda y período, y su descripción; el país sale del lead cuando lo tiene. El request tiene que estar libre: si ya respalda otra vacante, la acción responde REQUEST_ALREADY_LINKED y no escribe nada. Sin requestId es una búsqueda interna, sin cliente.
  • Un salario (salaryMin o salaryMax) necesita salaryPeriod y currencyCode, y el mínimo no puede superar al máximo; si no, responde INVALID.
  • La persona dueña de la API key queda como owner de la vacante.
  • No fija otro owner, ni la publicación en la career site, ni los umbrales, ni el idioma del contenido: se configuran en la app o con su propia acción.
POST/actions/create_job_post

Body

CampoTipoRequeridoDescripción
titlestringSíTítulo de la vacante. Hasta 200 caracteres.
descriptionstring | nullOpcionalDescripción de la vacante. Acepta HTML básico, que se sanea al guardarse. Hasta 50.000 caracteres.
seniorityenum | nullOpcionalNivel de seniority del puesto. Valores: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE.
employmentTypeenum | nullOpcionalTipo de empleo. Valores: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER.
workplaceTypeenum | nullOpcionalModalidad de trabajo. Valores: REMOTE, HYBRID, ON_SITE.
locationstring | nullOpcionalUbicación en texto libre, tal como se muestra. Hasta 200 caracteres.
countryenum | nullOpcionalPaís, en código ISO 3166-1 alfa-2 (AR, MX, ES, US…).
citystring | nullOpcionalCiudad. Para publicar es obligatoria si la modalidad es HYBRID u ON_SITE. Entre 3 y 200 caracteres.
salaryMinnumber | nullOpcionalSalario mínimo del rango. Necesita salaryPeriod y currencyCode. Mínimo 0.
salaryMaxnumber | nullOpcionalSalario máximo del rango. No puede ser menor que salaryMin. Mínimo 0.
currencyCodeenum | nullOpcionalMoneda del salario, en código ISO 4217 (USD, EUR, ARS, MXN…).
salaryPeriodenum | nullOpcionalPeríodo al que corresponde el salario. Valores: HOURLY, DAILY, MONTHLY, YEARLY.
targetStartDatestring (date) | nullOpcionalFecha de incorporación buscada. Formato YYYY-MM-DD.
openingsintegerOpcionalCantidad de posiciones a cubrir. Por defecto: 1, o las posiciones del request. Entre 1 y 500.
responsibilitiesstring[]OpcionalResponsabilidades del puesto, una por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
requirementsstring[]OpcionalRequisitos, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
niceToHavesstring[]OpcionalDeseables, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
benefitsstring[]OpcionalBeneficios, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
companyPitchstring | nullOpcionalPresentación de la empresa para candidatos. Hasta 50.000 caracteres.
bonusstring | nullOpcionalBono, en texto libre. Hasta 2.000 caracteres.
equitystring | nullOpcionalEquity, en texto libre. Hasta 2.000 caracteres.
requestIdstring (uuid) | nullOpcionalRequest del CRM que respalda la vacante (GET /crm/requests). Tiene que estar libre.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/create_job_post \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1d2c3b-create-backend-01" \
  -d '{
    "title": "Senior Backend Engineer",
    "description": "<p>Buscamos una persona para liderar el equipo de pagos.</p>",
    "seniority": "MID_SENIOR_LEVEL",
    "employmentType": "FULL_TIME",
    "workplaceType": "REMOTE",
    "country": "AR",
    "salaryMin": 4000,
    "salaryMax": 5500,
    "currencyCode": "USD",
    "salaryPeriod": "MONTHLY",
    "requestId": "2a9f4c6e-8b1d-4e3a-b5c7-0d9e8f7a6b52"
  }'

Respuesta

200 OK

{
  "data": {
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/new/manual/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
    },
    {
      "kind": "request",
      "id": "2a9f4c6e-8b1d-4e3a-b5c7-0d9e8f7a6b52",
      "label": "Backend Engineer para Nubetech",
      "href": "https://app.reclee.com/crm/requests/2a9f4c6e-8b1d-4e3a-b5c7-0d9e8f7a6b52"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "write_talent_icp",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      },
      {
        "tool": "write_sourcing_criteria",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      },
      {
        "tool": "write_screening_criteria",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      },
      {
        "tool": "write_evaluation_criteria",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      }
    ]
  },
  "cost": {
    "aiUsagePct": 0,
    "teamUsagePct": 0,
    "credits": 0,
    "billedLater": false
  }
}

next.missing lista lo que le falta para poder publicarse (description, seniority, employmentType, workplaceType, country y, si la modalidad es híbrida o presencial, city). Cuando ya tiene descripción y país, next.suggestions ofrece las generaciones que siguen, con readsFrom indicando de dónde leen.

Errores

CódigoHTTPCuándo
REQUEST_ALREADY_LINKED409El requestId ya respalda otra vacante. No se escribe nada.
NOT_FOUND404El requestId no existe en el workspace.
INVALID400Un salario sin período o sin moneda, o un mínimo mayor que el máximo.

Siguientes pasos típicos: update_job_post para completar campos, write_screening_criteria, write_evaluation_criteria y write_talent_icp. Cuando next.missing queda vacío, publícala con PUT /job-posts/{jobPostId}/status y {"status": "ACTIVE"}.

update_job_post

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

Edita los campos propios de una vacante y, si lo envías, su lista de condiciones: lo que se le pregunta a cada candidato antes de una oferta (preaviso, expectativa salarial…). Solo cambia lo que envías; un campo en null se vacía. Hace falta al menos un campo o conditions.

  • conditions reemplaza la lista entera, en orden, hasta 30. Las que se quedan van con su id (los lee GET /job-posts/{jobPostId}/conditions) para conservar lo que los candidatos ya respondieron; una nueva va sin id; la que no envíes se elimina.
  • El rango salarial se valida contra lo que ya está guardado: enviar solo salaryMin por encima del máximo guardado responde INVALID, igual que dejar un salario sin período o sin moneda.
  • No toca el owner (set_job_post_owner), la publicación, el request vinculado (link_request_to_job_post) ni los umbrales (set_recommendation_threshold).
  • La respuesta dice en careerSite dónde está la vacante en el sitio de empleo: VISIBLE (está publicada ahora, y el cambio es público apenas se guarda), ON_ACTIVATION (un borrador marcado para publicarse, que se hace público en cuanto se activa) o HIDDEN (no se publica).
POST/actions/update_job_post

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
titlestringOpcionalTítulo de la vacante. Hasta 200 caracteres.
descriptionstring | nullOpcionalDescripción de la vacante. Acepta HTML básico, que se sanea al guardarse. Hasta 50.000 caracteres.
seniorityenum | nullOpcionalNivel de seniority del puesto. Valores: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE.
employmentTypeenum | nullOpcionalTipo de empleo. Valores: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER.
workplaceTypeenum | nullOpcionalModalidad de trabajo. Valores: REMOTE, HYBRID, ON_SITE.
locationstring | nullOpcionalUbicación en texto libre, tal como se muestra. Hasta 200 caracteres.
countryenum | nullOpcionalPaís, en código ISO 3166-1 alfa-2 (AR, MX, ES, US…).
citystring | nullOpcionalCiudad. Para publicar es obligatoria si la modalidad es HYBRID u ON_SITE. Entre 3 y 200 caracteres.
salaryMinnumber | nullOpcionalSalario mínimo del rango. Necesita salaryPeriod y currencyCode. Mínimo 0.
salaryMaxnumber | nullOpcionalSalario máximo del rango. No puede ser menor que salaryMin. Mínimo 0.
currencyCodeenum | nullOpcionalMoneda del salario, en código ISO 4217 (USD, EUR, ARS, MXN…).
salaryPeriodenum | nullOpcionalPeríodo al que corresponde el salario. Valores: HOURLY, DAILY, MONTHLY, YEARLY.
targetStartDatestring (date) | nullOpcionalFecha de incorporación buscada. Formato YYYY-MM-DD.
openingsintegerOpcionalCantidad de posiciones a cubrir. Entre 1 y 500.
responsibilitiesstring[]OpcionalResponsabilidades del puesto, una por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
requirementsstring[]OpcionalRequisitos, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
niceToHavesstring[]OpcionalDeseables, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
benefitsstring[]OpcionalBeneficios, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres.
companyPitchstring | nullOpcionalPresentación de la empresa para candidatos. Hasta 50.000 caracteres.
bonusstring | nullOpcionalBono, en texto libre. Hasta 2.000 caracteres.
equitystring | nullOpcionalEquity, en texto libre. Hasta 2.000 caracteres.
conditionsobject[]OpcionalLista completa de condiciones, en orden. Reemplaza la actual. Hasta 30 elementos.
conditions[].idstring (uuid) | nullOpcionalId de una condición existente que se conserva. Omitido o null: una condición nueva.
conditions[].labelstringSíLo que se le pregunta al candidato. Hasta 200 caracteres.
conditions[].hintstring | nullOpcionalAyuda opcional que acompaña la pregunta. Hasta 500 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_job_post \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "workplaceType": "HYBRID",
    "conditions": [
      {
        "id": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
        "label": "Preaviso"
      },
      {
        "label": "Expectativa salarial",
        "hint": "Bruto mensual en USD"
      }
    ]
  }'

Respuesta

200 OK

{
  "data": {
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "careerSite": "HIDDEN",
    "conditions": 2
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/edit"
    }
  ],
  "next": {
    "missing": [
      "city"
    ],
    "suggestions": [
      {
        "tool": "update_job_post",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        }
      }
    ]
  }
}

data.conditions (cuántas condiciones quedaron) solo aparece si enviaste conditions. next.missing dice qué le falta para publicarse; en el ejemplo, la modalidad pasó a híbrida y falta la ciudad.

Errores

CódigoHTTPCuándo
INVALID400Ningún campo para cambiar, un rango salarial inválido contra lo guardado o un salario sin período o moneda.
NOT_FOUND404La vacante no existe en el workspace.

Para leer el estado actual antes de editar: GET /job-posts/{jobPostId}. Si es un borrador y next.missing quedó vacío, el paso siguiente es publicarlo con PUT /job-posts/{jobPostId}/status y {"status": "ACTIVE"}.

duplicate_job_post

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

Duplica una vacante en cualquier estado; lo habitual es copiar una cerrada para repetir la búsqueda, para el mismo cliente o para otro. La copia es un borrador nuevo con todo lo que define la búsqueda y nada de lo que produjo:

  • Copia: todos los campos, las etapas del pipeline, los criterios de sourcing, screening y evaluación (en orden y con sus knockouts), las condiciones, los umbrales, el idioma del contenido, la configuración de publicación, los miembros del equipo que siguen en el workspace y el perfil ideal con sus búsquedas sin empezar.
  • No copia: candidatos, longlists, corridas de sourcing, notas, links para clientes, suscriptores ni el request. La copia no tiene cliente hasta que le vincules uno con link_request_to_job_post.

El título recibe el sufijo «(copia)» o «(copy)» según el idioma del contenido, y quien duplica queda como owner. Revisa la fecha de inicio: casi siempre quedó en el pasado.

Para reintentar sin crear una segunda copia, envía Idempotency-Key (como en toda acción) o el campo idempotencyKey del body: con la misma clave vuelve la primera copia.

POST/actions/duplicate_job_post

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante original.
idempotencyKeystringOpcionalClave para reintentar sin duplicar dos veces: con la misma, vuelve la primera copia. Hasta 200 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/duplicate_job_post \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "idempotencyKey": "dup-backend-2026-10"
  }'

Respuesta

200 OK

{
  "data": {
    "jobPostId": "e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b",
    "title": "Senior Backend Engineer (copia)",
    "duplicatedFrom": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "copied": {
      "stages": 6,
      "sourcingCriteria": 8,
      "screeningQuestions": 5,
      "evaluationCriteria": 6,
      "conditions": 2,
      "teamMembers": 3,
      "talentIcps": 1,
      "searchDefinitions": 4
    }
  },
  "links": [
    {
      "kind": "job_post",
      "id": "e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b",
      "label": "Senior Backend Engineer (copia)",
      "href": "https://app.reclee.com/job-posts/new/manual/e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b"
    },
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "update_job_post",
        "input": {
          "jobPostId": "e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b"
        }
      }
    ]
  }
}

copied cuenta cuántas filas de cada tipo vinieron con la copia. next sugiere editarla con update_job_post y, si el original no las tenía, las generaciones que faltan.

Errores

CódigoHTTPCuándo
NOT_FOUND404La vacante original no existe en el workspace.
INVALID400Se reutilizó un idempotencyKey que ya se usó para duplicar otra vacante.

Para corregir lo que cambia en la copia (fecha, título, salario) sigue con update_job_post.

close_job_post

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

Cierra una vacante a mano: la búsqueda se detiene y sale de la career site. Funciona con o sin request vinculado y no cambia el request.

Si las contrataciones vigentes no llegaron a las posiciones (openings), hace falta closeReason; sin él responde CLOSE_REASON_REQUIRED con missing: ["closeReason"]. Un borrador no se cierra (INVALID): un borrador que nadie trabajó se elimina con delete_draft_job_post.

Las vacantes no se borran desde la API: cerrar es la forma de darlas de baja.

POST/actions/close_job_post

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
closeReasonstring | nullOpcionalMotivo del cierre. Obligatorio si las contrataciones no cubren las posiciones. Hasta 500 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/close_job_post \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "closeReason": "El cliente congeló la búsqueda hasta el próximo trimestre."
  }'

Respuesta

200 OK

{
  "data": {
    "status": "CLOSED"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

CódigoHTTPCuándo
CLOSE_REASON_REQUIRED422Faltan contrataciones para cubrir las posiciones y no se envió closeReason.
INVALID400La vacante es un borrador.
NOT_FOUND404La vacante no existe en el workspace.

Para volver a abrirla: reopen_job_post.

reopen_job_post

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

Reabre una vacante cerrada: vuelve a ACTIVE y la búsqueda sigue. Funciona con o sin request vinculado y no cambia el request.

Una vacante que ya está activa responde ALREADY_ACTIVE. Un borrador responde DRAFT_CANNOT_REOPEN: nunca se publicó, y publicarlo es otro paso (la app o PUT /job-posts/{jobPostId}/status), que revisa los campos que le faltan.

POST/actions/reopen_job_post

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/reopen_job_post \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
  }'

Respuesta

200 OK

{
  "data": {
    "status": "ACTIVE"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

CódigoHTTPCuándo
ALREADY_ACTIVE409La vacante ya está activa.
DRAFT_CANNOT_REOPEN409La vacante es un borrador.
NOT_FOUND404La vacante no existe en el workspace.

Lo contrario: close_job_post.

delete_draft_job_post

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

Elimina definitivamente una vacante que sigue en borrador y que nadie trabajó: sin candidatos en el pipeline, sin corridas de sourcing ni longlists y sin búsquedas pagas. Se va con sus criterios, su perfil ideal y sus etapas, y no se puede deshacer. Es la única vacante que se borra.

Cualquier otra (publicada, cerrada, o un borrador con algo de historia) responde JOB_POST_NOT_DELETABLE, con close_job_post en suggestions: esa se cierra con su motivo.

Llámala solo cuando la persona pidió borrar el borrador.

POST/actions/delete_draft_job_post

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/delete_draft_job_post \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
  }'

Respuesta

200 OK

{
  "data": {
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "title": "Data Analyst (borrador)",
    "deleted": true
  },
  "links": [],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "list_job_posts"
      }
    ]
  }
}

links viene vacío: la vacante ya no existe.

Errores

CódigoHTTPCuándo
JOB_POST_NOT_DELETABLE409No es un borrador, o es un borrador con candidatos, sourcing o búsquedas pagas.
NOT_FOUND404La vacante no existe en el workspace.

Para ver qué queda: GET /job-posts.

set_job_post_owner

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

Define quién lleva la vacante. ownerId es el memberId de GET /account/members, nunca su userId. El nuevo owner recibe una notificación solo si el owner realmente cambia.

POST/actions/set_job_post_owner

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
ownerIdstring (uuid)SímemberId del nuevo owner (GET /account/members). No es su userId.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/set_job_post_owner \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "ownerId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b"
  }'

Respuesta

200 OK

{
  "data": {
    "ownerId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La vacante o el miembro no existen en el workspace (por ejemplo, si enviaste un userId).

Para sumar gente sin cambiar el owner: add_job_post_member.

add_job_post_member

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

Suma a un miembro del workspace al equipo de la vacante, las personas que trabajan la búsqueda. No lo hace owner (set_job_post_owner) ni lo suscribe a las notificaciones (add_job_post_subscriber).

Alguien que ya está en el equipo no es un error: responde alreadyMember: true y no escribe nada.

POST/actions/add_job_post_member

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
workspaceMemberIdstring (uuid)SímemberId del miembro del workspace (GET /account/members). No es su userId.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/add_job_post_member \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "workspaceMemberId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b"
  }'

Respuesta

200 OK

{
  "data": {
    "workspaceMemberId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b",
    "alreadyMember": false
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "list_job_post_team",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        }
      }
    ]
  }
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La vacante o el miembro no existen en el workspace.

El equipo actual se lee con GET /job-posts/{jobPostId}/members.

remove_job_post_member

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

Saca a un miembro del equipo de la vacante. Sigue en el workspace, y sus comentarios, notas e historia sobre la vacante se quedan: solo se va la pertenencia al equipo. Alguien que no está en el equipo responde NOT_FOUND.

POST/actions/remove_job_post_member

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
workspaceMemberIdstring (uuid)SímemberId del miembro a sacar, tal como lo lista GET /job-posts/{jobPostId}/members.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/remove_job_post_member \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "workspaceMemberId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b"
  }'

Respuesta

200 OK

{
  "data": {
    "workspaceMemberId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b",
    "removed": true
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "list_job_post_team",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        }
      }
    ]
  }
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La vacante no existe o el miembro no está en su equipo.

El equipo actual se lee con GET /job-posts/{jobPostId}/members.

add_job_post_subscriber

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

Suscribe a un miembro a las notificaciones de la vacante: se entera de lo que pasa sin ser el owner. Alguien que ya está suscrito no es un error: devuelve su suscripción existente.

POST/actions/add_job_post_subscriber

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
workspaceMemberIdstring (uuid)SímemberId del miembro del workspace (GET /account/members). No es su userId.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/add_job_post_subscriber \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "workspaceMemberId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b"
  }'

Respuesta

200 OK

{
  "data": {
    "subscriptionId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La vacante o el miembro no existen en el workspace.

Lo contrario: remove_job_post_subscriber.

remove_job_post_subscriber

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

Quita a un miembro de las notificaciones de la vacante. Al owner no se lo puede desuscribir así: responde OWNER_CANNOT_UNSUBSCRIBE. Para que deje de recibirlas, primero pasa la vacante a otra persona con set_job_post_owner.

POST/actions/remove_job_post_subscriber

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
workspaceMemberIdstring (uuid)SímemberId del miembro del workspace (GET /account/members). No es su userId.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/remove_job_post_subscriber \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "workspaceMemberId": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b"
  }'

Respuesta

200 OK

{
  "data": {
    "removed": true
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

CódigoHTTPCuándo
OWNER_CANNOT_UNSUBSCRIBE409El miembro es el owner de la vacante.
NOT_FOUND404La vacante o el miembro no existen, o el miembro no estaba suscrito.

Lo contrario: add_job_post_subscriber.

set_pipeline_stages

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

Define el embudo completo de la vacante en una sola llamada: el orden del array es el orden del pipeline. Es la acción con más consecuencias de esta página, porque reordena todo el proceso.

  • Una etapa con id y sin name conserva el nombre que tiene hoy. Una etapa sin id es nueva y necesita name.
  • Agrega, renombra o reordena etapas, nunca elimina: todas las etapas actuales tienen que estar en el array. Omitir una responde STAGE_REMOVAL_NOT_ALLOWED; borrar etapas se hace en la app.
  • Las dos primeras etapas y las dos últimas (shortlist y contratación) están fijas: no se pueden renombrar (INVALID).
  • El pipeline tiene entre 3 y 12 etapas.
  • Si el embudo cambió entre tu lectura y la escritura (alguien sumó una etapa), responde PIPELINE_CHANGED y no escribe nada: vuelve a leerlo y envía el array completo otra vez.
POST/actions/set_pipeline_stages

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
stagesobject[]SíEl embudo completo, en orden. Tiene que incluir todas las etapas actuales. De 3 a 12 elementos.
stages[].idstring (uuid) | nullOpcionalId de una etapa existente. Omitido o null: una etapa nueva.
stages[].namestring | nullOpcionalNombre de la etapa. Obligatorio en una etapa nueva; en una existente, omitido conserva el actual. Hasta 80 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/set_pipeline_stages \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "stages": [
      {
        "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
      },
      {
        "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e"
      },
      {
        "id": "c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
        "name": "Entrevista técnica"
      },
      {
        "name": "Entrevista con el cliente"
      },
      {
        "id": "d5e6f7a8-9b0c-4d1e-af2a-3b4c5d6e7f8a"
      },
      {
        "id": "e6f7a8b9-0c1d-4e2f-b03b-4c5d6e7f8a9b"
      }
    ]
  }'

Respuesta

200 OK

{
  "data": {
    "stages": [
      "SOURCED",
      "SCREENING",
      "Entrevista técnica",
      "Entrevista con el cliente",
      "SHORTLIST",
      "HIRED"
    ]
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

stages devuelve el embudo resultante en orden. Una etapa que nadie renombró aparece con su clave de plantilla (SOURCED, SCREENING, INTERVIEW, SHORTLIST, HIRED); una renombrada, con su nombre.

Errores

CódigoHTTPCuándo
STAGE_REMOVAL_NOT_ALLOWED409Falta en el array alguna etapa actual.
PIPELINE_CHANGED409El embudo cambió desde que lo leíste. No se escribió nada.
NOT_FOUND404Un id no es una etapa de esta vacante, o la vacante no existe.
INVALID400Una etapa nueva sin nombre, una etapa fija renombrada, o menos de 3 etapas.

Lee las etapas actuales, con sus ids, en GET /job-posts/{jobPostId}/pipeline.

set_recommendation_threshold

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

Fija el puntaje mínimo de evaluación, de 0 a 5, a partir del cual el ATS marca a un candidato como recomendado. No confundir con el umbral de match que decide quién entra a la longlist durante el sourcing: este se aplica al puntaje de evaluación, cuando el candidato ya está en el pipeline.

POST/actions/set_recommendation_threshold

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
recommendationThresholdnumberSíPuntaje de evaluación mínimo para marcar a un candidato como recomendado. Entre 0 y 5.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/set_recommendation_threshold \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "recommendationThreshold": 3.5
  }'

Respuesta

200 OK

{
  "data": {
    "recommendationThreshold": 3.5
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

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

create_job_post_share

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

Crea el link que un cliente abre sin cuenta en Reclee:

  • SHORTLIST (por defecto) muestra a los candidatos en shortlist con sus reportes.
  • FULL muestra el pipeline completo.

showContact (por defecto false) revela el email y el teléfono de los candidatos: confírmalo con la persona antes de activarlo. expiresAt es un día o un instante futuro; un día solo (2026-12-31) vence al final de ese día en UTC. Sin expiresAt, el link no vence. label lo nombra para el equipo.

Una vacante tiene un solo link SHORTLIST vivo: crear otro responde SHORTLIST_LINK_ACTIVE, con revoke_job_post_share (y el shareId del link vivo) en suggestions.

POST/actions/create_job_post_share

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
scopeenumOpcionalQué ve el cliente: SHORTLIST (shortlist con reportes) o FULL (pipeline completo). Valores: FULL, SHORTLIST. Por defecto: "SHORTLIST".
labelstring | nullOpcionalNombre del link para el equipo. Hasta 120 caracteres.
showContactbooleanOpcionalSi el link muestra el email y el teléfono de los candidatos. Por defecto: false.
expiresAtstring (date) | string (datetime) | nullOpcionalVencimiento: un día (YYYY-MM-DD, vence al final del día en UTC) o un instante ISO 8601 en UTC. Tiene que ser futuro. Omitido: no vence. Formato YYYY-MM-DD. Fecha y hora ISO 8601 con zona horaria.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/create_job_post_share \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "scope": "SHORTLIST",
    "label": "Shortlist para Nubetech",
    "expiresAt": "2026-12-31"
  }'

Respuesta

200 OK

{
  "data": {
    "shareId": "f1e2d3c4-b5a6-4978-9a8b-7c6d5e4f3a2b",
    "scope": "SHORTLIST",
    "showContact": false,
    "expiresAt": "2026-12-31T23:59:59.999+00:00",
    "sharePath": "/public-shortlist/q8ZKt3mP1xVb7LwR"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "revoke_job_post_share",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
          "shareId": "f1e2d3c4-b5a6-4978-9a8b-7c6d5e4f3a2b"
        }
      }
    ]
  }
}

sharePath es la ruta del link en el dominio de la app: la URL que se le manda al cliente es https://app.reclee.com + sharePath. A diferencia de links, no viene absoluta.

Errores

CódigoHTTPCuándo
SHORTLIST_LINK_ACTIVE409La vacante ya tiene un link SHORTLIST vivo.
INVALID400expiresAt no es futuro.
NOT_FOUND404La vacante no existe en el workspace.

Los links de la vacante se listan con GET /job-posts/{jobPostId}/shares.

revoke_job_post_share

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

Revoca un link para clientes: quien tenga la URL deja de verlo en el acto. El link no se borra (queda en la lista de la vacante como revocado, como registro de quién tuvo acceso y hasta cuándo) y no se puede reactivar: un link nuevo tiene otra URL (create_job_post_share).

shareId sale de create_job_post_share o de la lista de links; si lo omites, revoca el link SHORTLIST vivo de la vacante.

POST/actions/revoke_job_post_share

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).
shareIdstring (uuid)OpcionalId del link a revocar. Omitido: el link SHORTLIST vivo de la vacante.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/revoke_job_post_share \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "shareId": "f1e2d3c4-b5a6-4978-9a8b-7c6d5e4f3a2b"
  }'

Respuesta

200 OK

{
  "data": {
    "shareId": "f1e2d3c4-b5a6-4978-9a8b-7c6d5e4f3a2b",
    "active": false
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "create_job_post_share",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        }
      }
    ]
  }
}

Errores

CódigoHTTPCuándo
NOT_FOUND404No hay un link con ese shareId en la vacante (o no hay link SHORTLIST vivo, si lo omitiste).
NOTHING_TO_CHANGE409El link ya estaba revocado.

Para crear uno nuevo: create_job_post_share.

create_note

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

Agrega una nota para el equipo sobre una de dos cosas, nunca las dos:

  • una persona del talent pool (profileId): la nota cruza todas las vacantes, no queda atada a una postulación;
  • una vacante (jobPostId): hasta 5.000 caracteres.

Enviar las dos, o ninguna, responde INVALID.

POST/actions/create_note

Body

CampoTipoRequeridoDescripción
profileIdstring (uuid)OpcionalLa persona del talent pool. Excluyente con jobPostId.
jobPostIdstring (uuid)OpcionalLa vacante. Excluyente con profileId; la nota de una vacante admite hasta 5000 caracteres.
bodystringSíTexto de la nota. Hasta 20.000 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/create_note \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "body": "El cliente pidió priorizar perfiles con experiencia en fintech."
  }'

Respuesta

200 OK

{
  "data": {
    "noteId": "2b3c4d5e-6f7a-4b8c-8d9e-0f1a2b3c4d5e"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

CódigoHTTPCuándo
INVALID400Se enviaron profileId y jobPostId a la vez, ninguno de los dos, o una nota de vacante de más de 5.000 caracteres.
NOT_FOUND404La persona o la vacante no existen en el workspace.

Para corregir una nota: update_note. Las notas se leen con GET /job-posts/{jobPostId}/notes y GET /profiles/{profileId}/notes.

update_note

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

Reescribe una nota que escribió la persona dueña de la API key. Las notas se corrigen, no se borran. Indica dónde está con uno de profileId o jobPostId, más noteId y el texto completo nuevo, que reemplaza al anterior.

Una nota de otra persona, o que no pertenece a esa persona o vacante, responde NOT_FOUND.

POST/actions/update_note

Body

CampoTipoRequeridoDescripción
profileIdstring (uuid)OpcionalLa persona donde está la nota. Excluyente con jobPostId.
jobPostIdstring (uuid)OpcionalLa vacante donde está la nota. Excluyente con profileId.
noteIdstring (uuid)SíId de la nota a reescribir.
bodystringSíTexto completo nuevo de la nota. Hasta 20.000 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_note \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "noteId": "2b3c4d5e-6f7a-4b8c-8d9e-0f1a2b3c4d5e",
    "body": "El cliente pidió priorizar perfiles con experiencia en fintech y pagos."
  }'

Respuesta

200 OK

{
  "data": {
    "noteId": "2b3c4d5e-6f7a-4b8c-8d9e-0f1a2b3c4d5e"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/overview"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La nota no existe en esa persona o vacante, o la escribió otra persona.
INVALID400Se enviaron profileId y jobPostId a la vez, o ninguno de los dos.

Para crear una nota: create_note.

write_evaluation_criteria

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

La IA lee la vacante y escribe sus criterios de evaluación: lo que las entrevistas tienen que averiguar, cada uno con peso HIGH, MEDIUM o LOW. De ellos sale después el scorecard de cada candidato. Ninguno es knockout: un requisito que por sí solo termina una candidatura va en el screening (write_screening_criteria).

  • Solo escribe sobre una vacante sin criterios de evaluación. Si ya tiene alguno responde ALREADY_WRITTEN: guardar una lista nueva borraría los que deja afuera junto con sus puntajes, y eso se revisa uno por uno en la pantalla de evaluación.
  • Necesita que la vacante tenga descripción y país; si no, responde JOB_POST_INCOMPLETE con lo que falta en missing y update_job_post en suggestions.
  • Escribe como máximo 30 criterios; si la propuesta trae más, responde TOO_MANY_CRITERIA.
  • Puede tardar: el servidor espera la respuesta del modelo dentro del mismo request.
POST/actions/write_evaluation_criteria

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/write_evaluation_criteria \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
  }'

Respuesta

200 OK

{
  "data": {
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "written": 6
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/edit?step=evaluation"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "write_talent_icp",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      },
      {
        "tool": "write_sourcing_criteria",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      }
    ]
  },
  "cost": {
    "aiUsagePct": 0.002,
    "teamUsagePct": 0,
    "credits": 0,
    "billedLater": false
  }
}

Devuelve cuántos criterios escribió y el link para revisarlos; el contenido se lee en la app o en GET /job-posts/{jobPostId}/evaluation-criteria. next ofrece las otras generaciones que la vacante todavía no tiene.

Errores

CódigoHTTPCuándo
ALREADY_WRITTEN409La vacante ya tiene criterios de evaluación.
JOB_POST_INCOMPLETE409A la vacante le falta descripción o país (missing dice cuál).
TOO_MANY_CRITERIA400La propuesta superó los 30 criterios. No se escribió nada.
USAGE_WINDOW402Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt).
USAGE_EXHAUSTED402Se agotó el uso de IA del mes.
TEAM_WINDOW402Se alcanzó el límite de cinco horas del uso compartido del equipo.
TEAM_USAGE_EXHAUSTED402Se agotó el uso compartido del equipo en el mes.

write_screening_criteria

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

La IA lee la vacante y escribe sus preguntas de screening: lo que cada candidato responde sobre sí mismo antes de que alguien lea su perfil. Una pregunta knockout termina la postulación por sí sola. Quedan marcadas como generadas por IA, así la app muestra quién las escribió.

  • Solo escribe sobre una vacante sin preguntas de screening. Si ya tiene alguna responde ALREADY_WRITTEN: guardar una lista nueva borraría las que deja afuera.
  • Necesita que la vacante tenga descripción y país; si no, responde JOB_POST_INCOMPLETE con lo que falta en missing.
  • Escribe como máximo 20 preguntas; si la propuesta trae más, responde TOO_MANY_CRITERIA.
  • Puede tardar: el servidor espera la respuesta del modelo dentro del mismo request.
POST/actions/write_screening_criteria

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíId de la vacante (GET /job-posts o GET /job-posts/{jobPostId}).

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/write_screening_criteria \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
  }'

Respuesta

200 OK

{
  "data": {
    "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
    "written": 5
  },
  "links": [
    {
      "kind": "job_post",
      "id": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01",
      "label": "Senior Backend Engineer",
      "href": "https://app.reclee.com/job-posts/7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01/edit?step=requirements"
    }
  ],
  "next": {
    "missing": [],
    "suggestions": [
      {
        "tool": "write_talent_icp",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      },
      {
        "tool": "write_sourcing_criteria",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      },
      {
        "tool": "write_evaluation_criteria",
        "input": {
          "jobPostId": "7c1e9a52-3b4d-4f8e-9a21-5d6c7b8e9f01"
        },
        "readsFrom": [
          "REQUEST",
          "PREVIOUS_STEPS"
        ]
      }
    ]
  },
  "cost": {
    "aiUsagePct": 0.002,
    "teamUsagePct": 0,
    "credits": 0,
    "billedLater": false
  }
}

Devuelve cuántas preguntas escribió y el link para revisarlas; el contenido se lee en la app o en GET /job-posts/{jobPostId}/screening-questions.

Errores

CódigoHTTPCuándo
ALREADY_WRITTEN409La vacante ya tiene preguntas de screening.
JOB_POST_INCOMPLETE409A la vacante le falta descripción o país (missing dice cuál).
TOO_MANY_CRITERIA400La propuesta superó las 20 preguntas. No se escribió nada.
USAGE_WINDOW402Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt).
USAGE_EXHAUSTED402Se agotó el uso de IA del mes.
TEAM_WINDOW402Se alcanzó el límite de cinco horas del uso compartido del equipo.
TEAM_USAGE_EXHAUSTED402Se agotó el uso compartido del equipo en el mes.

En esta página