Career site
La configuración del sitio público de empleos del workspace, su dirección y la lista de vacantes publicadas.
El career site es la página pública de empleos de tu workspace: la lista de vacantes publicadas y una página por vacante donde los candidatos se postulan. Vive en https://<slug>.reclee.com, donde <slug> es la dirección pública del workspace.
Las rutas de esta página sirven para leer y editar cómo se ve ese sitio (color, tipografía, idioma, textos del encabezado, enlaces del pie), para cambiar su dirección y para leer la lista de vacantes tal como la ve un visitante. Qué vacantes aparecen y con qué datos (cliente, salario, cantidad de postulantes) se decide en cada vacante, no acá.
Permisos
Cualquier miembro puede leer la configuración y consultar si una dirección está libre. Editar el sitio, cambiar la dirección y activar la marca blanca es solo del OWNER: con la key de otro rol esas rutas contestan 403 FORBIDDEN.
Configuración
GET /careers/settings
/careers/settingsDevuelve la configuración del career site del workspace, con lo que hace falta para editarla: si quien llama puede editar, si el plan incluye marca blanca, cuándo se puede volver a cambiar la dirección y qué direcciones anteriores siguen redirigiendo. Un workspace que nunca guardó nada devuelve el diseño por defecto (accent: "#2f4bd9", font: "default", locale: "es") con savedAt: null.
curl https://app.reclee.com/api/v1/careers/settings \
-H "Authorization: Bearer rcl_..."Respuesta:
{
"slug": "talento-norte",
"workspaceName": "Talento Norte",
"logoUrl": "https://…/logo.png?token=…",
"accent": "#2f4bd9",
"font": "default",
"locale": "es",
"headTitle": "Trabaja con nuestros clientes",
"headDescription": null,
"contactEmail": "talento@talentonorte.example",
"website": "talentonorte.example",
"privacyUrl": null,
"social": {
"linkedin": "linkedin.com/company/talento-norte-example",
"instagram": null,
"x": null,
"facebook": null,
"youtube": null,
"tiktok": null
},
"poweredBy": true,
"canEdit": true,
"whiteLabel": { "allowed": false, "on": false },
"slugChangeableAt": null,
"previousSlugs": [
{ "slug": "talentonorte", "resolvesUntil": "2027-08-01T12:00:00.000Z" }
],
"savedAt": "2026-10-01T15:20:00.000Z"
}logoUrles el avatar del workspace, con una URL firmada que vence a la hora;nullsi no tiene. No se edita desde esta ruta.poweredBydice si el pie muestra «powered by Reclee»: esfalsesolo con marca blanca activa en un plan que la incluye.slugChangeableAtes la fecha desde la que se puede volver a cambiar la dirección, onullsi se puede ahora.previousSlugslista las direcciones que el workspace dejó y que siguen redirigiendo, con la fecha hasta la que lo hacen.
PUT /careers/settings
/careers/settingsGuarda el sitio entero de una vez: es un PUT, así que se mandan todos los campos, incluso los que no cambian. Devuelve la configuración guardada, con la misma forma que GET /careers/settings. Solo OWNER.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| accent | string | Sí | Color de acento en hexadecimal (#2f4bd9 o #0af, que se guarda como #00aaff). |
| font | enum | Sí | Tipografía: default, instrument, plex o serif. |
| locale | enum | Sí | Idioma de las páginas que no son de una vacante: es o en. |
| headTitle | string | null | Sí | Título del encabezado, hasta 60 caracteres. Vacío o null usa el texto por defecto en el idioma del sitio. |
| headDescription | string | null | Sí | Bajada del encabezado, hasta 180 caracteres. Vacío o null usa el texto por defecto. |
| contactEmail | string | null | Sí | Email de contacto del pie. Tiene que ser un email válido; vacío o null lo quita. |
| website | string | null | Sí | Sitio web de la empresa, hasta 255 caracteres. Acepta un dominio sin esquema (talentonorte.example). |
| privacyUrl | string | null | Sí | Política de privacidad, mismas reglas que website. |
| social | object | Sí | Las seis redes, todas presentes: linkedin, instagram, x, facebook, youtube, tiktok. Cada una es una dirección web o null. |
Un campo de más (por ejemplo slug) contesta 400 INVALID: la dirección se cambia con PUT /careers/slug. Un enlace que no es una dirección web (javascript:…, ftp://…, una palabra sin dominio) también es 400 INVALID.
curl -X PUT https://app.reclee.com/api/v1/careers/settings \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"accent": "#1f7a5c",
"font": "plex",
"locale": "es",
"headTitle": "Trabaja con nuestros clientes",
"headDescription": "Búsquedas abiertas en tecnología y finanzas.",
"contactEmail": "talento@talentonorte.example",
"website": "talentonorte.example",
"privacyUrl": null,
"social": {
"linkedin": "linkedin.com/company/talento-norte-example",
"instagram": null, "x": null, "facebook": null, "youtube": null, "tiktok": null
}
}'PUT /careers/settings/white-label
/careers/settings/white-labelSaca o vuelve a poner el «powered by Reclee» del career site y de la shortlist compartida. Devuelve la configuración completa, con la forma de GET /careers/settings. Solo OWNER.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| on | boolean | Sí | true activa la marca blanca (sin «powered by Reclee»); false la apaga. |
Si el plan no incluye marca blanca, activarla contesta 402 PLAN_REQUIRED. whiteLabel.allowed en GET /careers/settings te dice de antemano si el plan la incluye.
curl -X PUT https://app.reclee.com/api/v1/careers/settings/white-label \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "on": true }'Dirección pública
GET /careers/slug/availability
/careers/slug/availabilityDice si una dirección está libre para tu workspace, sin cambiar nada. Devuelve un string: AVAILABLE, TAKEN (la usa otro workspace o la está reteniendo), RESERVED (es una palabra reservada) o INVALID (no tiene la forma de una dirección). Una dirección que tu propio workspace dejó cuenta como AVAILABLE: puedes volver a ella.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| slug | string | Sí | La dirección a consultar, hasta 63 caracteres. Se pasa a minúsculas. |
Una dirección válida tiene letras minúsculas, números y guiones, y no empieza ni termina con guion.
curl "https://app.reclee.com/api/v1/careers/slug/availability?slug=talento-norte" \
-H "Authorization: Bearer rcl_..."Respuesta:
"AVAILABLE"PUT /careers/slug
/careers/slugCambia la dirección pública del workspace. Devuelve la configuración completa, con la forma de GET /careers/settings. Solo OWNER.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| slug | string | Sí | La nueva dirección, hasta 63 caracteres: minúsculas, números y guiones, sin guion al principio ni al final. |
Reglas del cambio:
- La dirección vieja sigue redirigiendo a la nueva durante 12 meses, y en ese tiempo ningún otro workspace la puede tomar. Aparece en
previousSlugs. - Después de un cambio hay que esperar 30 días para el siguiente (
slugChangeableAt). Volver a la dirección anterior no espera.
Errores específicos:
| Código | Status | Cuándo |
|---|---|---|
INVALID | 400 | La dirección no tiene la forma válida o es una palabra reservada. |
SLUG_TAKEN | 409 | La usa otro workspace, o la está reteniendo. |
SLUG_COOLING_DOWN | 409 | No pasaron 30 días desde el último cambio. |
FORBIDDEN | 403 | Quien llama no es OWNER. |
curl -X PUT https://app.reclee.com/api/v1/careers/slug \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "slug": "talento-norte" }'Vacantes publicadas
GET /careers/job-posts
/careers/job-postsDevuelve las vacantes que muestra el career site de un workspace, con los mismos datos y en el mismo orden que ve un visitante: publicadas, de la más reciente a la más vieja, y solo con lo que cada vacante decidió mostrar. No incluye el id interno de la vacante: cada una se identifica por su slug, el código corto de su URL pública.
No usa la paginación estándar de la API: pagina por offset y limit, y devuelve { jobPosts, total, limit, offset }. Una página fuera de rango devuelve jobPosts: [] con el total real. Un slug que no corresponde a ningún sitio también devuelve una lista vacía, no un error.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| slug | string | Sí | La dirección pública del workspace cuyo sitio quieres leer. |
| offset | integer | Opcional | Cuántas vacantes saltear. Default 0. |
| limit | integer | Opcional | Cuántas traer, de 1 a 100. Default 100. |
curl "https://app.reclee.com/api/v1/careers/job-posts?slug=talento-norte&limit=20" \
-H "Authorization: Bearer rcl_..."Respuesta:
{
"jobPosts": [
{
"slug": "k7m2qa",
"title": "Backend Developer Sr.",
"paused": false,
"clientName": null,
"applicantCount": 34,
"openedAt": "2026-09-28T13:00:00.000Z",
"city": "Córdoba",
"country": "Argentina",
"workplaceType": "HYBRID",
"employmentType": "FULL_TIME",
"seniority": "MID_SENIOR_LEVEL",
"salary": { "min": 3000, "max": 4200, "currencyCode": "USD", "period": "MONTHLY" },
"contentLocale": "es"
}
],
"total": 1,
"limit": 20,
"offset": 0
}clientName: nulles una búsqueda confidencial;applicantCount: null, un contador que la vacante no muestra;salary: null, un salario privado.paused: truees una vacante pausada: sigue visible pero no recibe postulaciones.workplaceType:REMOTE,HYBRIDuON_SITE.employmentType:FULL_TIME,PART_TIME,CONTRACT,INTERNSHIP,TEMPORARY,VOLUNTEERuOTHER.seniority:INTERNSHIP,ENTRY_LEVEL,ASSOCIATE,MID_SENIOR_LEVEL,DIRECTOR,EXECUTIVEoNOT_APPLICABLE.salary.period:HOURLY,DAILY,MONTHLYoYEARLY.
Para leer o editar las vacantes de tu propio workspace con todos sus datos, usa la referencia de vacantes.