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
/account/meDevuelve 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:falsesi solo entró con Google.avatarUrl: una URL firmada y temporal para mostrar la foto;nullsi no hay.
PATCH /account/me
/account/meEdita 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.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| firstName | string | Opcional | Nombre, de 1 a 80 caracteres. Se puede omitir pero no vaciar. |
| lastName | string | Opcional | Apellido, de 1 a 80 caracteres. |
| locale | "es" | "en" | Opcional | Idioma de la app y de los mails. |
| theme | "light" | "dark" | "system" | Opcional | Tema 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
/account/me/avatarQuita 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
/account/me/passwordEn 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
/account/me/leaveLa 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_..."| Error | Status | Cuándo |
|---|---|---|
LAST_OWNER | 409 | Es la única OWNER activa. Antes tiene que transferir la propiedad o nombrar otra OWNER. |
Onboarding
GET /account/me/onboarding
/account/me/onboardingDevuelve 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
/account/me/onboarding/completeMarca 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
/account/me/onboarding/checklist/dismissCierra 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
/account/membersLista 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:falsemientras 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;nullsi se puede ahora o no hay nada que reenviar.isLastOwner/isSelf: la única OWNER activa, y la fila de quien llama.
POST /account/members
/account/membersInvita 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.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| string | Sí | Email válido, hasta 320 caracteres. | |
| firstName | string | Opcional | Nombre, hasta 80 caracteres. |
| lastName | string | Opcional | Apellido, hasta 80 caracteres. |
| role | "OWNER" | "RECRUITER" | "COLLABORATOR" | "VIEWER" | Opcional | Rol 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" }'| Error | Status | Cuándo |
|---|---|---|
ALREADY_MEMBER | 409 | Ya es miembro activo. |
ALREADY_INVITED | 409 | Ya tiene una invitación pendiente: usa POST /account/members/{memberId}/resend. |
SEAT_LIMIT | 402 | El rol ocupa un asiento y el plan no tiene lugar. |
PAYMENT_FAILED | 402 | No se pudo cobrar el asiento. |
EMAIL_RATE_LIMITED | 429 | Se alcanzó el límite de envío de mails; reintenta más tarde. |
PATCH /account/members/{memberId}
/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.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| memberId | uuid (path) | Sí | El memberId de la fila del equipo. |
| role | "OWNER" | "RECRUITER" | "COLLABORATOR" | "VIEWER" | Opcional | Rol nuevo. |
| active | boolean | Opcional | false 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" }'| Error | Status | Cuándo |
|---|---|---|
NOT_FOUND | 404 | No hay un miembro con ese id en el workspace. |
LAST_OWNER | 409 | El cambio dejaría al workspace sin OWNER activa. |
SELF_DEACTIVATION | 409 | No puedes desactivar tu propia membresía desde aquí: usa POST /account/me/leave. |
SELF_DEMOTION | 409 | No puedes quitarte tu propio rol de OWNER. |
ACCOUNT_DELETED | 409 | La persona borró su cuenta y no se puede reactivar. |
SEAT_LIMIT | 402 | El rol nuevo ocupa un asiento y el plan no tiene lugar. |
DELETE /account/members/{memberId}
/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_..."| Error | Status | Cuándo |
|---|---|---|
NOT_FOUND | 404 | No hay un miembro con ese id. |
ALREADY_ACCEPTED | 409 | La invitación ya fue aceptada. |
POST /account/members/{memberId}/resend
/account/members/{memberId}/resendReenví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_..."| Error | Status | Cuándo |
|---|---|---|
NOT_FOUND | 404 | No hay un miembro con ese id. |
ALREADY_ACCEPTED | 409 | La invitación ya fue aceptada. |
ALREADY_CONFIRMED | 409 | La persona confirmó su email sin elegir contraseña: no queda mail de invitación para mandar. |
RESEND_TOO_SOON | 429 | Se alcanzó el tope de reenvíos. |
POST /account/members/{memberId}/ownership
/account/members/{memberId}/ownershipEn 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
/account/api-keysLista 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
/account/api-keys/{apiKeyId}/revokeRevoca 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.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| apiKeyId | uuid (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_..."| Error | Status | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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
/account/workspaceDevuelve 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*yguaranteeDays: los honorarios y los días de garantía con los que arranca cada cliente nuevo del CRM.canEdit:truesolo para OWNER.joinDomain: el dominio de mail cuyas cuentas nuevas entran comoVIEWERsin invitación;nullsi está cerrado.
PATCH /account/workspace
/account/workspaceEdita 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.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Opcional | Nombre, de 1 a 120 caracteres. |
| website | string | null | Opcional | Sitio web, hasta 255 caracteres. Vacío o null lo borra. |
| segment | "AGENCY" | "IN_HOUSE" | Opcional | Para quién recluta el workspace. |
| companySize | string | null | Opcional | ONE_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" | Opcional | Tipo de honorario por defecto. PERCENTAGE usa el porcentaje; FIXED, el monto y la moneda; MIXED, los tres. |
| defaultFeePct | number | null | Opcional | Porcentaje, de 0 a 100. |
| defaultFeeAmount | number | null | Opcional | Monto fijo, mayor que 0. |
| defaultFeeCurrency | string | null | Opcional | Código de moneda ISO 4217 (por ejemplo USD). |
| guaranteeDays | integer | Opcional | Dí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
/account/workspace/deletion/previewLo 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:truesolo para una OWNER en la app; por API es siemprefalse.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
/account/workspace/deletionDevuelve el borrado programado, o null si no hay ninguno.
curl https://app.reclee.com/api/v1/account/workspace/deletion \
-H "Authorization: Bearer rcl_..."nullSi hay uno programado, la respuesta trae workspaceId, name, scheduledFor (fecha ISO 8601), source (APP o CONSOLE) y canCancel.
POST /account/workspace/deletion
/account/workspace/deletionEn 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
/account/workspace/deletionEn la app, cancela un borrado programado. Por API siempre contesta 403 FORBIDDEN.