Reclee

Cuenta y workspace

Tu perfil, los miembros del workspace, las API keys, los datos del workspace, el onboarding y el borrado del workspace.

Estas rutas leen y editan lo que rodea al trabajo: la persona dueña de la API key (su perfil, su onboarding, su salida del workspace), el equipo (miembros e invitaciones), las API keys y la configuración del workspace. Todo responde sobre el workspace al que pertenece la key.

La key hereda el rol de la persona que la creó. Muchas rutas de esta página son solo para OWNER: con la key de otro rol contestan 403 FORBIDDEN. Algunas operaciones que mueven plata o cierran la cuenta (transferir la propiedad, programar el borrado del workspace, crear una contraseña) exigen que el OWNER esté en persona en la app: por API contestan siempre 403 FORBIDDEN, aunque la key sea de un OWNER. Están documentadas para que sepas que existen y qué esperar.

Perfil propio

GET /account/me

GET/account/me

Devuelve el perfil de la persona dueña de la key.

curl https://app.reclee.com/api/v1/account/me \
  -H "Authorization: Bearer rcl_..."
{
  "userId": "4f6a2c1e-8b3d-4e7a-9c21-5d0b7e3f1a62",
  "email": "laura.mendez@talentoandino.com",
  "firstName": "Laura",
  "lastName": "Méndez",
  "locale": "es",
  "theme": "system",
  "isLastOwner": false,
  "hasPassword": true,
  "avatarPath": "4f6a2c1e-8b3d-4e7a-9c21-5d0b7e3f1a62/avatar.png",
  "avatarUrl": "https://..."
}
  • isLastOwner: es la única OWNER activa; mientras sea así no puede salir del workspace.
  • hasPassword: false si solo entró con Google.
  • avatarUrl: una URL firmada y temporal para mostrar la foto; null si no hay.

PATCH /account/me

PATCH/account/me

Edita el nombre y las preferencias. Envía solo los campos que cambian; un campo desconocido es 400 INVALID. El email no se cambia por aquí. Devuelve el perfil completo, como GET /account/me.

CampoTipoRequeridoDescripción
firstNamestringOpcionalNombre, de 1 a 80 caracteres. Se puede omitir pero no vaciar.
lastNamestringOpcionalApellido, de 1 a 80 caracteres.
locale"es" | "en"OpcionalIdioma de la app y de los mails.
theme"light" | "dark" | "system"OpcionalTema de la app.
curl -X PATCH https://app.reclee.com/api/v1/account/me \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{ "locale": "en" }'

DELETE /account/me/avatar

DELETE/account/me/avatar

Quita la foto de perfil. Devuelve el perfil con avatarPath y avatarUrl en null. Si no había foto, devuelve el perfil sin cambios. Subir una foto nueva se hace desde la app.

curl -X DELETE https://app.reclee.com/api/v1/account/me/avatar \
  -H "Authorization: Bearer rcl_..."

POST /account/me/password

POST/account/me/password

En la app, manda el mail para que alguien que solo entró con Google cree una contraseña. Por API siempre contesta 403 FORBIDDEN: una API key no alcanza para tocar la contraseña de una cuenta.

POST /account/me/leave

POST/account/me/leave

La persona dueña de la key sale del workspace. No se borra nada: la membresía queda inactiva y lo que escribió conserva su nombre. Devuelve true. Desde ese momento la key deja de funcionar.

curl -X POST https://app.reclee.com/api/v1/account/me/leave \
  -H "Authorization: Bearer rcl_..."
ErrorStatusCuándo
LAST_OWNER409Es la única OWNER activa. Antes tiene que transferir la propiedad o nombrar otra OWNER.

Onboarding

GET /account/me/onboarding

GET/account/me/onboarding

Devuelve si la persona ya vio la orientación inicial y, para una OWNER que no la cerró, la lista de primeros pasos del workspace.

curl https://app.reclee.com/api/v1/account/me/onboarding \
  -H "Authorization: Bearer rcl_..."
{
  "orientationDone": true,
  "checklist": {
    "items": {
      "workspace": true,
      "jobPost": true,
      "prepared": false,
      "longlist": false
    },
    "sourcingJobPostId": "9b1d3c7e-2a4f-4b8e-a6d0-3e5f7c9a1b24"
  }
}

checklist es null para cualquier rol que no sea OWNER y para una OWNER que ya la cerró. Los ítems son: el workspace creado, una vacante publicada, una vacante preparada para sourcing y una longlist cerrada. sourcingJobPostId es la vacante a la que apunta el último paso.

POST /account/me/onboarding/complete

POST/account/me/onboarding/complete

Marca la orientación como vista (o salteada). Sirve para cualquier rol. Devuelve la fecha en que quedó marcada, como string ISO 8601; una segunda llamada devuelve la primera fecha.

curl -X POST https://app.reclee.com/api/v1/account/me/onboarding/complete \
  -H "Authorization: Bearer rcl_..."
"2026-10-14T13:05:22.418Z"

POST /account/me/onboarding/checklist/dismiss

POST/account/me/onboarding/checklist/dismiss

Cierra la lista de primeros pasos para la OWNER que llama (cada OWNER cierra la suya). Devuelve la fecha de cierre como string ISO 8601. Solo OWNER: cualquier otro rol recibe 403 FORBIDDEN.

curl -X POST https://app.reclee.com/api/v1/account/me/onboarding/checklist/dismiss \
  -H "Authorization: Bearer rcl_..."

Miembros

Los roles son OWNER, RECRUITER, COLLABORATOR y VIEWER. OWNER y RECRUITER ocupan un asiento del plan: invitar o promover a alguien a esos roles puede cobrar un asiento, y si el plan no tiene lugar la respuesta es 402 SEAT_LIMIT. Todas las rutas de esta sección son solo para OWNER.

GET /account/members

GET/account/members

Lista el equipo, incluidas las invitaciones pendientes y los miembros desactivados. Pagina con page y pageSize (hasta 200, 50 por defecto): ver paginación.

curl "https://app.reclee.com/api/v1/account/members?page=1&pageSize=50" \
  -H "Authorization: Bearer rcl_..."
{
  "rows": [
    {
      "memberId": "c3e8a1f4-6b2d-4a9e-8f17-2d5c9b0e4a73",
      "userId": "7a2d9e4b-1c6f-4f3a-b8e5-0d9c2a6f1e48",
      "email": "martin.rios@talentoandino.com",
      "firstName": "Martín",
      "lastName": "Ríos",
      "avatarPath": null,
      "avatarUrl": null,
      "role": "RECRUITER",
      "active": true,
      "accepted": false,
      "deleted": false,
      "resendableAt": "2026-10-14T13:10:00.000Z",
      "createdAt": "2026-10-14T13:05:00.000Z",
      "isLastOwner": false,
      "isSelf": false
    }
  ],
  "total": 6,
  "page": 1,
  "pageSize": 50
}
  • accepted: false mientras la invitación está pendiente.
  • deleted: la persona borró su cuenta; la fila queda por lo que hizo.
  • resendableAt: cuándo se puede reenviar la invitación; null si se puede ahora o no hay nada que reenviar.
  • isLastOwner / isSelf: la única OWNER activa, y la fila de quien llama.

POST /account/members

POST/account/members

Invita a una persona por email. Si ya tiene cuenta en Reclee recibe un aviso; si no, un mail para crear su contraseña. Si la persona había estado en el workspace y estaba desactivada, se la reactiva con el rol pedido. Devuelve el equipo completo actualizado (un array de miembros, sin paginar). Acepta Idempotency-Key.

CampoTipoRequeridoDescripción
emailstringSíEmail válido, hasta 320 caracteres.
firstNamestringOpcionalNombre, hasta 80 caracteres.
lastNamestringOpcionalApellido, hasta 80 caracteres.
role"OWNER" | "RECRUITER" | "COLLABORATOR" | "VIEWER"OpcionalRol con el que entra. Por defecto, RECRUITER.
curl -X POST https://app.reclee.com/api/v1/account/members \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5d2c8e1a-invite-martin" \
  -d '{ "email": "martin.rios@talentoandino.com", "firstName": "Martín", "role": "RECRUITER" }'
ErrorStatusCuándo
ALREADY_MEMBER409Ya es miembro activo.
ALREADY_INVITED409Ya tiene una invitación pendiente: usa POST /account/members/{memberId}/resend.
SEAT_LIMIT402El rol ocupa un asiento y el plan no tiene lugar.
PAYMENT_FAILED402No se pudo cobrar el asiento.
EMAIL_RATE_LIMITED429Se alcanzó el límite de envío de mails; reintenta más tarde.

PATCH /account/members/{memberId}

PATCH/account/members/{memberId}

Cambia el rol de un miembro o lo activa / desactiva. Hay que mandar al menos uno de los dos campos. Un miembro nunca se borra: se desactiva con { "active": false }. Devuelve el equipo completo actualizado.

CampoTipoRequeridoDescripción
memberIduuid (path)SíEl memberId de la fila del equipo.
role"OWNER" | "RECRUITER" | "COLLABORATOR" | "VIEWER"OpcionalRol nuevo.
activebooleanOpcionalfalse desactiva la membresía; true la reactiva.
curl -X PATCH https://app.reclee.com/api/v1/account/members/c3e8a1f4-6b2d-4a9e-8f17-2d5c9b0e4a73 \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{ "role": "COLLABORATOR" }'
ErrorStatusCuándo
NOT_FOUND404No hay un miembro con ese id en el workspace.
LAST_OWNER409El cambio dejaría al workspace sin OWNER activa.
SELF_DEACTIVATION409No puedes desactivar tu propia membresía desde aquí: usa POST /account/me/leave.
SELF_DEMOTION409No puedes quitarte tu propio rol de OWNER.
ACCOUNT_DELETED409La persona borró su cuenta y no se puede reactivar.
SEAT_LIMIT402El rol nuevo ocupa un asiento y el plan no tiene lugar.

DELETE /account/members/{memberId}

DELETE/account/members/{memberId}

Cancela una invitación pendiente, y solo eso. Una membresía aceptada no se borra (se desactiva con PATCH). Devuelve el equipo completo actualizado.

curl -X DELETE https://app.reclee.com/api/v1/account/members/c3e8a1f4-6b2d-4a9e-8f17-2d5c9b0e4a73 \
  -H "Authorization: Bearer rcl_..."
ErrorStatusCuándo
NOT_FOUND404No hay un miembro con ese id.
ALREADY_ACCEPTED409La invitación ya fue aceptada.

POST /account/members/{memberId}/resend

POST/account/members/{memberId}/resend

Reenvía el mail de una invitación pendiente. Hay un tope de un reenvío cada cinco minutos y cinco por día; el campo resendableAt del equipo dice cuándo se vuelve a poder. Devuelve el equipo completo actualizado.

curl -X POST https://app.reclee.com/api/v1/account/members/c3e8a1f4-6b2d-4a9e-8f17-2d5c9b0e4a73/resend \
  -H "Authorization: Bearer rcl_..."
ErrorStatusCuándo
NOT_FOUND404No hay un miembro con ese id.
ALREADY_ACCEPTED409La invitación ya fue aceptada.
ALREADY_CONFIRMED409La persona confirmó su email sin elegir contraseña: no queda mail de invitación para mandar.
RESEND_TOO_SOON429Se alcanzó el tope de reenvíos.

POST /account/members/{memberId}/ownership

POST/account/members/{memberId}/ownership

En la app, la OWNER transfiere la propiedad del workspace a otro miembro y elige con qué rol se queda (stayAs: RECRUITER, COLLABORATOR, VIEWER o LEAVE para salir). Por API siempre contesta 403 FORBIDDEN: puede cobrar un asiento y cambiar el email de facturación, así que exige a la OWNER en persona.

API keys

Una API key se crea solo desde la app (Configuración → Developers): una key nunca crea otra, así que no hay POST. Solo pueden crearla quienes ocupan un asiento (OWNER y RECRUITER). Una key funciona mientras la persona dueña siga activa y con un rol de asiento; si la desactivan o la pasan a COLLABORATOR o VIEWER, la key queda dormida (no se revoca) y vuelve a funcionar si recupera el asiento.

GET /account/api-keys

GET/account/api-keys

Lista las keys que puedes ver: las tuyas y, si eres OWNER, las de todo el workspace. Primero las vigentes y después las revocadas, de la más nueva a la más vieja. El secreto nunca vuelve: solo el prefijo. Pagina con page y pageSize (hasta 200, 50 por defecto): ver paginación.

curl https://app.reclee.com/api/v1/account/api-keys \
  -H "Authorization: Bearer rcl_..."
{
  "rows": [
    {
      "id": "e1b7c4d2-3f8a-4c6e-9a05-7b2d1f8e3c90",
      "name": "Integración con el ERP",
      "keyPrefix": "rcl_8fK2",
      "createdAt": "2026-09-30T18:22:10.000Z",
      "lastUsedAt": "2026-10-21T09:41:03.000Z",
      "revokedAt": null,
      "workspaceMemberId": "a8f3d6c1-9e2b-4b7a-8c45-1f0e3d7b9a26",
      "mine": true,
      "ownerName": "Laura Méndez",
      "ownerRole": "OWNER",
      "ownerActive": true,
      "resolves": true
    }
  ],
  "total": 2,
  "page": 1,
  "pageSize": 50
}
  • resolves: si la key funciona hoy (no revocada, y su dueña activa, con la invitación aceptada y con un rol de asiento).
  • mine: si es tuya.
  • ownerName: nombre de la dueña, o su email si no tiene nombre.

POST /account/api-keys/{apiKeyId}/revoke

POST/account/api-keys/{apiKeyId}/revoke

Revoca una key: deja de funcionar en el request siguiente y sigue en la lista marcada como revocada. Puedes revocar las tuyas; una OWNER puede revocar cualquiera del workspace. Revocarla dos veces contesta lo mismo. Devuelve true.

CampoTipoRequeridoDescripción
apiKeyIduuid (path)SíEl id de la key, de GET /account/api-keys.
curl -X POST https://app.reclee.com/api/v1/account/api-keys/e1b7c4d2-3f8a-4c6e-9a05-7b2d1f8e3c90/revoke \
  -H "Authorization: Bearer rcl_..."
ErrorStatusCuándo
NOT_FOUND404La key no existe o no es una que puedas revocar.

Revocar la propia key

Si revocas la key con la que estás llamando, la respuesta llega igual, pero el siguiente request contesta 401 UNAUTHENTICATED.

Workspace

GET /account/workspace

GET/account/workspace

Devuelve los datos del workspace. Cualquier rol puede leerlos.

curl https://app.reclee.com/api/v1/account/workspace \
  -H "Authorization: Bearer rcl_..."
{
  "id": "2b6e9f1c-4d3a-4e8b-a7c2-9f0d5e1b3a68",
  "name": "Talento Andino",
  "slug": "talento-andino",
  "avatarPath": null,
  "avatarUrl": null,
  "website": "https://talentoandino.com",
  "segment": "AGENCY",
  "companySize": "ELEVEN_TO_FIFTY",
  "defaultFeeType": "PERCENTAGE",
  "defaultFeePct": 18,
  "defaultFeeAmount": null,
  "defaultFeeCurrency": null,
  "guaranteeDays": 90,
  "canEdit": true,
  "joinDomain": null,
  "callerDomain": "talentoandino.com",
  "callerDomainIsPublic": false
}
  • slug: la dirección del workspace. No cambia al renombrarlo.
  • defaultFee* y guaranteeDays: los honorarios y los días de garantía con los que arranca cada cliente nuevo del CRM.
  • canEdit: true solo para OWNER.
  • joinDomain: el dominio de mail cuyas cuentas nuevas entran como VIEWER sin invitación; null si está cerrado.

PATCH /account/workspace

PATCH/account/workspace

Edita los datos del workspace. Solo OWNER. Envía solo los campos que cambian. Los honorarios van completos: si envías cualquiera de defaultFeeType, defaultFeePct, defaultFeeAmount o defaultFeeCurrency, tienes que enviar los cuatro, con null en las partes que el tipo no usa. Devuelve el workspace actualizado.

CampoTipoRequeridoDescripción
namestringOpcionalNombre, de 1 a 120 caracteres.
websitestring | nullOpcionalSitio web, hasta 255 caracteres. Vacío o null lo borra.
segment"AGENCY" | "IN_HOUSE"OpcionalPara quién recluta el workspace.
companySizestring | nullOpcionalONE_TO_TEN, ELEVEN_TO_FIFTY, FIFTY_ONE_TO_HUNDRED, HUNDRED_ONE_TO_TWO_HUNDRED, TWO_HUNDRED_ONE_TO_FIVE_HUNDRED o FIVE_HUNDRED_PLUS.
defaultFeeType"PERCENTAGE" | "FIXED" | "MIXED"OpcionalTipo de honorario por defecto. PERCENTAGE usa el porcentaje; FIXED, el monto y la moneda; MIXED, los tres.
defaultFeePctnumber | nullOpcionalPorcentaje, de 0 a 100.
defaultFeeAmountnumber | nullOpcionalMonto fijo, mayor que 0.
defaultFeeCurrencystring | nullOpcionalCódigo de moneda ISO 4217 (por ejemplo USD).
guaranteeDaysintegerOpcionalDías de garantía, de 1 a 365.
curl -X PATCH https://app.reclee.com/api/v1/account/workspace \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "defaultFeeType": "MIXED",
    "defaultFeePct": 12,
    "defaultFeeAmount": 1500,
    "defaultFeeCurrency": "USD",
    "guaranteeDays": 60
  }'

slug no se puede editar: un campo que no existe en el schema contesta 400 INVALID.

Borrado del workspace

Programar el borrado del workspace y cancelarlo son decisiones de una OWNER en persona, en la app. Por API se puede leer el estado; programarlo o cancelarlo contesta 403 FORBIDDEN. Mientras el borrado está programado el workspace queda suspendido y sus API keys dejan de funcionar.

GET /account/workspace/deletion/preview

GET/account/workspace/deletion/preview

Lo que hay que saber antes de programar el borrado.

curl https://app.reclee.com/api/v1/account/workspace/deletion/preview \
  -H "Authorization: Bearer rcl_..."
{
  "internal": false,
  "canSchedule": false,
  "paying": true,
  "periodEnd": "2026-11-03T00:00:00.000Z",
  "lostPaidDays": 12
}
  • canSchedule: true solo para una OWNER en la app; por API es siempre false.
  • paying, periodEnd, lostPaidDays: si hay una suscripción paga, se cancela al programar el borrado, sin reembolso, y se pierden esos días pagos.

GET /account/workspace/deletion

GET/account/workspace/deletion

Devuelve el borrado programado, o null si no hay ninguno.

curl https://app.reclee.com/api/v1/account/workspace/deletion \
  -H "Authorization: Bearer rcl_..."
null

Si hay uno programado, la respuesta trae workspaceId, name, scheduledFor (fecha ISO 8601), source (APP o CONSOLE) y canCancel.

POST /account/workspace/deletion

POST/account/workspace/deletion

En la app, programa el borrado (pide el nombre del workspace escrito y, si hay suscripción paga, el motivo de la cancelación). Por API siempre contesta 403 FORBIDDEN.

DELETE /account/workspace/deletion

DELETE/account/workspace/deletion

En la app, cancela un borrado programado. Por API siempre contesta 403 FORBIDDEN.

En esta página