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
requestIdla vacante queda vinculada a ese request del CRM, y cada campo que omitas se toma de él:openingsde 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 respondeREQUEST_ALREADY_LINKEDy no escribe nada. SinrequestIdes una búsqueda interna, sin cliente. - Un salario (
salaryMinosalaryMax) necesitasalaryPeriodycurrencyCode, y el mínimo no puede superar al máximo; si no, respondeINVALID. - 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.
/actions/create_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| title | string | Sí | Título de la vacante. Hasta 200 caracteres. |
| description | string | null | Opcional | Descripción de la vacante. Acepta HTML básico, que se sanea al guardarse. Hasta 50.000 caracteres. |
| seniority | enum | null | Opcional | Nivel de seniority del puesto. Valores: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE. |
| employmentType | enum | null | Opcional | Tipo de empleo. Valores: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER. |
| workplaceType | enum | null | Opcional | Modalidad de trabajo. Valores: REMOTE, HYBRID, ON_SITE. |
| location | string | null | Opcional | Ubicación en texto libre, tal como se muestra. Hasta 200 caracteres. |
| country | enum | null | Opcional | País, en código ISO 3166-1 alfa-2 (AR, MX, ES, US…). |
| city | string | null | Opcional | Ciudad. Para publicar es obligatoria si la modalidad es HYBRID u ON_SITE. Entre 3 y 200 caracteres. |
| salaryMin | number | null | Opcional | Salario mínimo del rango. Necesita salaryPeriod y currencyCode. Mínimo 0. |
| salaryMax | number | null | Opcional | Salario máximo del rango. No puede ser menor que salaryMin. Mínimo 0. |
| currencyCode | enum | null | Opcional | Moneda del salario, en código ISO 4217 (USD, EUR, ARS, MXN…). |
| salaryPeriod | enum | null | Opcional | Período al que corresponde el salario. Valores: HOURLY, DAILY, MONTHLY, YEARLY. |
| targetStartDate | string (date) | null | Opcional | Fecha de incorporación buscada. Formato YYYY-MM-DD. |
| openings | integer | Opcional | Cantidad de posiciones a cubrir. Por defecto: 1, o las posiciones del request. Entre 1 y 500. |
| responsibilities | string[] | Opcional | Responsabilidades del puesto, una por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| requirements | string[] | Opcional | Requisitos, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| niceToHaves | string[] | Opcional | Deseables, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| benefits | string[] | Opcional | Beneficios, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| companyPitch | string | null | Opcional | Presentación de la empresa para candidatos. Hasta 50.000 caracteres. |
| bonus | string | null | Opcional | Bono, en texto libre. Hasta 2.000 caracteres. |
| equity | string | null | Opcional | Equity, en texto libre. Hasta 2.000 caracteres. |
| requestId | string (uuid) | null | Opcional | Request 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ódigo | HTTP | Cuándo |
|---|---|---|
REQUEST_ALREADY_LINKED | 409 | El requestId ya respalda otra vacante. No se escribe nada. |
NOT_FOUND | 404 | El requestId no existe en el workspace. |
INVALID | 400 | Un 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.
conditionsreemplaza la lista entera, en orden, hasta 30. Las que se quedan van con suid(los leeGET /job-posts/{jobPostId}/conditions) para conservar lo que los candidatos ya respondieron; una nueva va sinid; la que no envíes se elimina.- El rango salarial se valida contra lo que ya está guardado: enviar solo
salaryMinpor encima del máximo guardado respondeINVALID, 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
careerSitedó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) oHIDDEN(no se publica).
/actions/update_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| title | string | Opcional | Título de la vacante. Hasta 200 caracteres. |
| description | string | null | Opcional | Descripción de la vacante. Acepta HTML básico, que se sanea al guardarse. Hasta 50.000 caracteres. |
| seniority | enum | null | Opcional | Nivel de seniority del puesto. Valores: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, NOT_APPLICABLE. |
| employmentType | enum | null | Opcional | Tipo de empleo. Valores: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER. |
| workplaceType | enum | null | Opcional | Modalidad de trabajo. Valores: REMOTE, HYBRID, ON_SITE. |
| location | string | null | Opcional | Ubicación en texto libre, tal como se muestra. Hasta 200 caracteres. |
| country | enum | null | Opcional | País, en código ISO 3166-1 alfa-2 (AR, MX, ES, US…). |
| city | string | null | Opcional | Ciudad. Para publicar es obligatoria si la modalidad es HYBRID u ON_SITE. Entre 3 y 200 caracteres. |
| salaryMin | number | null | Opcional | Salario mínimo del rango. Necesita salaryPeriod y currencyCode. Mínimo 0. |
| salaryMax | number | null | Opcional | Salario máximo del rango. No puede ser menor que salaryMin. Mínimo 0. |
| currencyCode | enum | null | Opcional | Moneda del salario, en código ISO 4217 (USD, EUR, ARS, MXN…). |
| salaryPeriod | enum | null | Opcional | Período al que corresponde el salario. Valores: HOURLY, DAILY, MONTHLY, YEARLY. |
| targetStartDate | string (date) | null | Opcional | Fecha de incorporación buscada. Formato YYYY-MM-DD. |
| openings | integer | Opcional | Cantidad de posiciones a cubrir. Entre 1 y 500. |
| responsibilities | string[] | Opcional | Responsabilidades del puesto, una por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| requirements | string[] | Opcional | Requisitos, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| niceToHaves | string[] | Opcional | Deseables, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| benefits | string[] | Opcional | Beneficios, uno por elemento. Hasta 100 elementos. Cada uno de hasta 2.000 caracteres. |
| companyPitch | string | null | Opcional | Presentación de la empresa para candidatos. Hasta 50.000 caracteres. |
| bonus | string | null | Opcional | Bono, en texto libre. Hasta 2.000 caracteres. |
| equity | string | null | Opcional | Equity, en texto libre. Hasta 2.000 caracteres. |
| conditions | object[] | Opcional | Lista completa de condiciones, en orden. Reemplaza la actual. Hasta 30 elementos. |
| conditions[].id | string (uuid) | null | Opcional | Id de una condición existente que se conserva. Omitido o null: una condición nueva. |
| conditions[].label | string | Sí | Lo que se le pregunta al candidato. Hasta 200 caracteres. |
| conditions[].hint | string | null | Opcional | Ayuda 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ódigo | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | Ningún campo para cambiar, un rango salarial inválido contra lo guardado o un salario sin período o moneda. |
NOT_FOUND | 404 | La 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.
/actions/duplicate_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante original. |
| idempotencyKey | string | Opcional | Clave 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La vacante original no existe en el workspace. |
INVALID | 400 | Se 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.
/actions/close_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| closeReason | string | null | Opcional | Motivo 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ódigo | HTTP | Cuándo |
|---|---|---|
CLOSE_REASON_REQUIRED | 422 | Faltan contrataciones para cubrir las posiciones y no se envió closeReason. |
INVALID | 400 | La vacante es un borrador. |
NOT_FOUND | 404 | La 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.
/actions/reopen_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
ALREADY_ACTIVE | 409 | La vacante ya está activa. |
DRAFT_CANNOT_REOPEN | 409 | La vacante es un borrador. |
NOT_FOUND | 404 | La 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.
/actions/delete_draft_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
JOB_POST_NOT_DELETABLE | 409 | No es un borrador, o es un borrador con candidatos, sourcing o búsquedas pagas. |
NOT_FOUND | 404 | La 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.
/actions/set_job_post_ownerBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| ownerId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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.
/actions/add_job_post_memberBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| workspaceMemberId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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.
/actions/remove_job_post_memberBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| workspaceMemberId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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.
/actions/add_job_post_subscriberBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| workspaceMemberId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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.
/actions/remove_job_post_subscriberBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| workspaceMemberId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
OWNER_CANNOT_UNSUBSCRIBE | 409 | El miembro es el owner de la vacante. |
NOT_FOUND | 404 | La 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
idy sinnameconserva el nombre que tiene hoy. Una etapa sinides nueva y necesitaname. - 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_CHANGEDy no escribe nada: vuelve a leerlo y envía el array completo otra vez.
/actions/set_pipeline_stagesBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| stages | object[] | Sí | El embudo completo, en orden. Tiene que incluir todas las etapas actuales. De 3 a 12 elementos. |
| stages[].id | string (uuid) | null | Opcional | Id de una etapa existente. Omitido o null: una etapa nueva. |
| stages[].name | string | null | Opcional | Nombre 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ódigo | HTTP | Cuándo |
|---|---|---|
STAGE_REMOVAL_NOT_ALLOWED | 409 | Falta en el array alguna etapa actual. |
PIPELINE_CHANGED | 409 | El embudo cambió desde que lo leíste. No se escribió nada. |
NOT_FOUND | 404 | Un id no es una etapa de esta vacante, o la vacante no existe. |
INVALID | 400 | Una 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.
/actions/set_recommendation_thresholdBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| recommendationThreshold | number | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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.FULLmuestra 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.
/actions/create_job_post_shareBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| scope | enum | Opcional | Qué ve el cliente: SHORTLIST (shortlist con reportes) o FULL (pipeline completo). Valores: FULL, SHORTLIST. Por defecto: "SHORTLIST". |
| label | string | null | Opcional | Nombre del link para el equipo. Hasta 120 caracteres. |
| showContact | boolean | Opcional | Si el link muestra el email y el teléfono de los candidatos. Por defecto: false. |
| expiresAt | string (date) | string (datetime) | null | Opcional | Vencimiento: 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ódigo | HTTP | Cuándo |
|---|---|---|
SHORTLIST_LINK_ACTIVE | 409 | La vacante ya tiene un link SHORTLIST vivo. |
INVALID | 400 | expiresAt no es futuro. |
NOT_FOUND | 404 | La 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.
/actions/revoke_job_post_shareBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | Id de la vacante (GET /job-posts o GET /job-posts/{jobPostId}). |
| shareId | string (uuid) | Opcional | Id 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | No hay un link con ese shareId en la vacante (o no hay link SHORTLIST vivo, si lo omitiste). |
NOTHING_TO_CHANGE | 409 | El 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.
/actions/create_noteBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | string (uuid) | Opcional | La persona del talent pool. Excluyente con jobPostId. |
| jobPostId | string (uuid) | Opcional | La vacante. Excluyente con profileId; la nota de una vacante admite hasta 5000 caracteres. |
| body | string | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | Se enviaron profileId y jobPostId a la vez, ninguno de los dos, o una nota de vacante de más de 5.000 caracteres. |
NOT_FOUND | 404 | La 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.
/actions/update_noteBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | string (uuid) | Opcional | La persona donde está la nota. Excluyente con jobPostId. |
| jobPostId | string (uuid) | Opcional | La vacante donde está la nota. Excluyente con profileId. |
| noteId | string (uuid) | Sí | Id de la nota a reescribir. |
| body | string | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La nota no existe en esa persona o vacante, o la escribió otra persona. |
INVALID | 400 | Se 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_INCOMPLETEcon lo que falta enmissingyupdate_job_postensuggestions. - 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.
/actions/write_evaluation_criteriaBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
ALREADY_WRITTEN | 409 | La vacante ya tiene criterios de evaluación. |
JOB_POST_INCOMPLETE | 409 | A la vacante le falta descripción o país (missing dice cuál). |
TOO_MANY_CRITERIA | 400 | La propuesta superó los 30 criterios. No se escribió nada. |
USAGE_WINDOW | 402 | Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt). |
USAGE_EXHAUSTED | 402 | Se agotó el uso de IA del mes. |
TEAM_WINDOW | 402 | Se alcanzó el límite de cinco horas del uso compartido del equipo. |
TEAM_USAGE_EXHAUSTED | 402 | Se agotó el uso compartido del equipo en el mes. |
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_INCOMPLETEcon lo que falta enmissing. - 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.
/actions/write_screening_criteriaBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
ALREADY_WRITTEN | 409 | La vacante ya tiene preguntas de screening. |
JOB_POST_INCOMPLETE | 409 | A la vacante le falta descripción o país (missing dice cuál). |
TOO_MANY_CRITERIA | 400 | La propuesta superó las 20 preguntas. No se escribió nada. |
USAGE_WINDOW | 402 | Se alcanzó el límite de uso de IA de la ventana de cinco horas. Vuelve solo; la respuesta dice cuándo (resetsAt). |
USAGE_EXHAUSTED | 402 | Se agotó el uso de IA del mes. |
TEAM_WINDOW | 402 | Se alcanzó el límite de cinco horas del uso compartido del equipo. |
TEAM_USAGE_EXHAUSTED | 402 | Se agotó el uso compartido del equipo en el mes. |