Reclee

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

GET/careers/settings

Devuelve 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"
}
  • logoUrl es el avatar del workspace, con una URL firmada que vence a la hora; null si no tiene. No se edita desde esta ruta.
  • poweredBy dice si el pie muestra «powered by Reclee»: es false solo con marca blanca activa en un plan que la incluye.
  • slugChangeableAt es la fecha desde la que se puede volver a cambiar la dirección, o null si se puede ahora.
  • previousSlugs lista las direcciones que el workspace dejó y que siguen redirigiendo, con la fecha hasta la que lo hacen.

PUT /careers/settings

PUT/careers/settings

Guarda 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.

CampoTipoRequeridoDescripción
accentstringSíColor de acento en hexadecimal (#2f4bd9 o #0af, que se guarda como #00aaff).
fontenumSíTipografía: default, instrument, plex o serif.
localeenumSíIdioma de las páginas que no son de una vacante: es o en.
headTitlestring | nullSíTítulo del encabezado, hasta 60 caracteres. Vacío o null usa el texto por defecto en el idioma del sitio.
headDescriptionstring | nullSíBajada del encabezado, hasta 180 caracteres. Vacío o null usa el texto por defecto.
contactEmailstring | nullSíEmail de contacto del pie. Tiene que ser un email válido; vacío o null lo quita.
websitestring | nullSíSitio web de la empresa, hasta 255 caracteres. Acepta un dominio sin esquema (talentonorte.example).
privacyUrlstring | nullSíPolítica de privacidad, mismas reglas que website.
socialobjectSí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

PUT/careers/settings/white-label

Saca 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.

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

GET/careers/slug/availability

Dice 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.

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

PUT/careers/slug

Cambia la dirección pública del workspace. Devuelve la configuración completa, con la forma de GET /careers/settings. Solo OWNER.

CampoTipoRequeridoDescripción
slugstringSí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ódigoStatusCuándo
INVALID400La dirección no tiene la forma válida o es una palabra reservada.
SLUG_TAKEN409La usa otro workspace, o la está reteniendo.
SLUG_COOLING_DOWN409No pasaron 30 días desde el último cambio.
FORBIDDEN403Quien 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

GET/careers/job-posts

Devuelve 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.

CampoTipoRequeridoDescripción
slugstringSíLa dirección pública del workspace cuyo sitio quieres leer.
offsetintegerOpcionalCuántas vacantes saltear. Default 0.
limitintegerOpcionalCuá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: null es una búsqueda confidencial; applicantCount: null, un contador que la vacante no muestra; salary: null, un salario privado.
  • paused: true es una vacante pausada: sigue visible pero no recibe postulaciones.
  • workplaceType: REMOTE, HYBRID u ON_SITE. employmentType: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER u OTHER. seniority: INTERNSHIP, ENTRY_LEVEL, ASSOCIATE, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE o NOT_APPLICABLE. salary.period: HOURLY, DAILY, MONTHLY o YEARLY.

Para leer o editar las vacantes de tu propio workspace con todos sus datos, usa la referencia de vacantes.

En esta página