Talent pool
Acciones para cargar, editar, etiquetar, marcar, depurar y adjuntar archivos a las personas del talent pool del workspace.
El talent pool es la base de personas que tu workspace decidió conservar: candidatos que cargaste a mano, que llegaron por CV o por planilla, que guardaste desde una búsqueda de talento, que agregaste a una lista o a una vacante. Cada persona tiene un profileId estable, y sobre ese id trabajan todas las acciones de esta página.
Hay dos capas de datos por persona. El perfil público (lo que viene de LinkedIn a través del proveedor de datos) es compartido y no se edita desde acá. La versión propia del workspace (titular, ubicación, resumen, idiomas, skills y carrera que alguien de tu equipo cargó o corrigió) es privada del workspace y se edita con update_profile. Los contactos que tu equipo tipea, las etiquetas, la marca de «no contactar» y los adjuntos también son privados del workspace.
Las acciones se encadenan así: una persona entra con create_profile, upload_cv o save_to_pool (después de una búsqueda de talento); se completa con update_profile, add_profile_contact y upload_attachment; se organiza con etiquetas (add_profile_tag) y listas; y se depura con resolve_merge_candidate (duplicados) o remove_from_pool. Ninguna de estas acciones borra datos: archivan, corrigen o marcan.
Cómo se llama una acción
Todas las acciones son POST https://app.reclee.com/api/v1/actions/<nombre> con un body JSON y Authorization: Bearer rcl_…. La respuesta exitosa es un objeto con data (el resultado), links (los objetos que tocó, con la URL absoluta de su pantalla en la app), y según el caso next (qué falta y qué acción sigue) y cost (lo que gastó). Los errores comunes a todas las acciones (INVALID, UNAUTHENTICATED, RATE_LIMITED…) están en Errores; acá solo se listan los propios de cada acción. Puedes reintentar sin duplicar nada con un header Idempotency-Key (Idempotencia).
create_profile
Familia: DO · No consume créditos ni uso: no se le compra nada al proveedor de datos.
Agrega una persona al talent pool a mano. Necesita el nombre y al menos un identificador: un email o la URL de su perfil de LinkedIn. Opcionalmente, su cargo, empresa y ubicación actuales; una empresa sin cargo se rechaza (title es obligatorio si mandas company). La URL de LinkedIn tiene que ser el perfil de una persona (linkedin.com/in/…), no la página de una empresa ni un post.
Si alguien del pool ya tiene ese email o ese LinkedIn, no se escribe nada: la respuesta trae created: false, el profileId de la persona que ya estaba y una note que lo explica. No es un error, así que revisa created antes de asumir que la persona es nueva.
/actions/create_profileBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre completo. De 1 a 200 caracteres. |
| string (email) | Opcional | Email de la persona. Máximo 320 caracteres. Hace falta email o linkedin. | |
| string | Opcional | URL del perfil de LinkedIn de la persona (linkedin.com/in/…). Máximo 300 caracteres. Hace falta email o linkedin. | |
| phone | string | Opcional | Teléfono. Máximo 40 caracteres. |
| headline | string | Opcional | Titular (la línea debajo del nombre). Máximo 200 caracteres. |
| title | string | Opcional | Cargo actual. Máximo 200 caracteres. Obligatorio si mandas company. |
| company | string | Opcional | Empresa actual. Máximo 200 caracteres. |
| location | string | Opcional | Ubicación. Máximo 200 caracteres. |
| summary | string | Opcional | Resumen. Máximo 4000 caracteres. |
| skills | string[] | Opcional | Skills. Hasta 60, cada una de 1 a 80 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/create_profile \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Lucía Ferreyra",
"email": "lucia.ferreyra@example.com",
"linkedin": "https://www.linkedin.com/in/lucia-ferreyra-dev",
"title": "Senior Backend Engineer",
"company": "Nubeluz",
"location": "Córdoba, Argentina",
"skills": ["Go", "PostgreSQL", "Kubernetes"]
}'Respuesta
{
"data": {
"profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"created": true
},
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
}
]
}Si la persona ya estaba:
{
"data": {
"profileId": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"created": false,
"note": "This person was already in the pool under that email or LinkedIn, so nothing was written. The link opens the profile that was already there."
},
"links": [
{
"kind": "profile",
"id": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | Falta email y linkedin, hay company sin title, o linkedin no es el perfil de una persona. details dice qué campo. |
PROFILE_INVALID | 400 | Los datos no se pudieron guardar tal como llegaron (por ejemplo, un LinkedIn que no es de una persona detectado al escribir). |
update_profile
Familia: DO · No consume créditos ni uso.
Edita la versión propia del workspace del perfil de una persona: titular, ubicación, resumen, idiomas verificados, idiomas, skills y la carrera (puestos, estudios, certificaciones y proyectos). Nunca pisa: cada llamada escribe una versión nueva encima de la actual, la historia queda, y todo lo que no mandes se copia sin cambios.
Reglas para armar el body:
nullvacía un campo de texto.languagesyskillsreemplazan la lista entera: manda la lista completa que quieres.- La carrera nunca se manda entera.
addPositions,addEducation,addCertificationsyaddProjectsagregan entradas;removePositions,removeEducation,removeCertificationsyremoveProjectssacan entradas por su índice (desde 0) en la carrera propia actual. Para editar una entrada, saca su índice y agrega la versión corregida en la misma llamada. - Los años son números (
startYear: 2020). Un puesto o proyecto vigente llevaisCurrent: truey no llevaendYear. baseVersiones obligatorio: es la versión propia sobre la que calculaste los índices, onullsi el workspace nunca escribió una. Léela antes: es la versión más nueva deGET /talent/pool/{profileId}/own, oownProfileVersionen la tool de lecturaget_profilepor MCP (que además traeownCareercon los índices). Si mientras tanto alguien guardó otra versión, la acción contestaPROFILE_CHANGED: vuelve a leer y rehaz el cambio, índices incluidos.- Si el workspace nunca escribió una versión, la primera parte del perfil público (como el editor de la app). Una entrada de esa carrera que no se puede guardar tal cual (un puesto sin empresa, un año fuera de rango) queda afuera de la versión nueva.
Topes de la carrera: 30 puestos, 20 estudios, 30 certificaciones y 20 proyectos.
/actions/update_profileBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | string (uuid) | Sí | La persona. |
| baseVersion | integer | null | Sí | Versión propia actual (mínimo 1), o null si nunca se escribió una. |
| headline | string | null | Opcional | Titular. Máximo 200 caracteres. null lo vacía. |
| location | string | null | Opcional | Ubicación. Máximo 200 caracteres. |
| summary | string | null | Opcional | Resumen. Máximo 4000 caracteres. |
| verifiedLanguages | string | null | Opcional | Idiomas que alguien del equipo verificó, en texto libre. Máximo 400 caracteres. |
| languages | string[] | Opcional | Reemplaza la lista. Hasta 20, de 1 a 80 caracteres cada uno. |
| skills | string[] | Opcional | Reemplaza la lista. Hasta 60, de 1 a 80 caracteres cada una. |
| addPositions | object[] | Opcional | Puestos a agregar (hasta 30). |
| addPositions[].title | string | Sí | Cargo. De 1 a 200 caracteres. |
| addPositions[].organizationName | string | Sí | Empresa. De 1 a 200 caracteres. |
| addPositions[].description | string | Opcional | Máximo 2000 caracteres. |
| addPositions[].isCurrent | boolean | Opcional | Puesto vigente. Default false. |
| addPositions[].startYear / endYear | integer | Opcional | Entre 1900 y 2100. |
| addPositions[].startMonth / endMonth | integer | Opcional | Entre 1 y 12. |
| removePositions | integer[] | Opcional | Índices (desde 0) de puestos a sacar. Hasta 30. |
| addEducation | object[] | Opcional | Estudios a agregar (hasta 20). |
| addEducation[].schoolName | string | Sí | Institución. De 1 a 200 caracteres. |
| addEducation[].degree | string | Opcional | Título. Máximo 200 caracteres. |
| addEducation[].fieldOfStudy | string | Opcional | Área. Máximo 200 caracteres. |
| addEducation[].startYear / endYear | integer | Opcional | Entre 1900 y 2100. |
| removeEducation | integer[] | Opcional | Índices de estudios a sacar. Hasta 20. |
| addCertifications | object[] | Opcional | Certificaciones a agregar (hasta 30). |
| addCertifications[].name | string | Sí | De 1 a 200 caracteres. |
| addCertifications[].authority | string | Opcional | Quién la emite. Máximo 200 caracteres. |
| addCertifications[].url | string | Opcional | Máximo 500 caracteres. |
| addCertifications[].issuedYear | integer | Opcional | Entre 1900 y 2100. |
| removeCertifications | integer[] | Opcional | Índices de certificaciones a sacar. Hasta 30. |
| addProjects | object[] | Opcional | Proyectos a agregar (hasta 20). |
| addProjects[].name | string | Sí | De 1 a 200 caracteres. |
| addProjects[].description | string | Opcional | Máximo 2000 caracteres. |
| addProjects[].url | string (uri) | Opcional | http o https. Máximo 500 caracteres. |
| addProjects[].isCurrent | boolean | Opcional | Proyecto vigente. Default false. |
| addProjects[].startYear / endYear | integer | Opcional | Entre 1900 y 2100. |
| addProjects[].startMonth / endMonth | integer | Opcional | Entre 1 y 12. |
| removeProjects | integer[] | Opcional | Índices de proyectos a sacar. Hasta 20. |
Hace falta al menos un campo para cambiar además de profileId y baseVersion.
Ejemplo
Corrige el puesto en el índice 0 (lo saca y agrega la versión corregida) y reemplaza las skills:
curl -X POST https://app.reclee.com/api/v1/actions/update_profile \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"baseVersion": 2,
"removePositions": [0],
"addPositions": [
{
"title": "Staff Backend Engineer",
"organizationName": "Nubeluz",
"isCurrent": true,
"startYear": 2022,
"startMonth": 3
}
],
"skills": ["Go", "PostgreSQL", "Kubernetes", "gRPC"]
}'Respuesta
version es el número de la versión que se acaba de escribir.
{
"data": { "version": 3 },
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
PROFILE_CHANGED | 409 | Otra versión se guardó después de baseVersion. Lee de nuevo y rehaz el cambio. |
CAREER_ENTRY_NOT_FOUND | 404 | Un índice de remove… no existe en la carrera propia actual. |
CAREER_TOO_LONG | 400 | Una lista superaría su tope (30 puestos, 20 estudios, 30 certificaciones, 20 proyectos). |
NOTHING_TO_CHANGE | 409 | La llamada no cambiaría nada. |
PROFILE_INVALID | 400 | La versión resultante no es válida. |
NOT_FOUND | 404 | La persona no está en el workspace. |
add_profile_contact
Familia: DO · No consume créditos.
Guarda un email o un teléfono que alguien de tu equipo tipeó para una persona del pool. Queda privado del workspace y marcado como cargado a mano. Usala solo con datos que la persona te dio: para buscar contactos con el proveedor está enrich_contact.
Si no mandas type, el valor tiene que ser un email y se clasifica como laboral o personal según el dominio. Si el workspace ya tiene ese mismo valor para la persona, la acción devuelve el contacto existente en lugar de crear una copia. El contactId de la respuesta es el que usa update_profile_contact: un contacto tipeado se corrige, no se borra.
/actions/add_profile_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | string (uuid) | Sí | La persona. |
| type | enum | Opcional | EMAIL_WORK, EMAIL_PERSONAL o PHONE. Sin type, el valor tiene que ser un email. |
| value | string | Sí | El email o teléfono. De 1 a 254 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/add_profile_contact \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"type": "PHONE",
"value": "+54 351 555 0142"
}'Respuesta
{
"data": {
"contactId": "c4e8b2a1-6d3f-4a9e-b7c5-1e2f3a4b5c6d",
"type": "PHONE"
},
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
}
],
"next": {
"missing": [],
"suggestions": [
{
"tool": "update_profile_contact",
"input": {
"profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"contactId": "c4e8b2a1-6d3f-4a9e-b7c5-1e2f3a4b5c6d"
}
}
]
}
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | El valor no es un email válido (sin type o con un tipo de email) o no parece un teléfono. |
NOT_FOUND | 404 | La persona no está en el workspace. |
update_profile_contact
Familia: DO · No consume créditos.
Corrige un email o teléfono que tu equipo cargó a mano. El contacto conserva su id y sigue siendo privado del workspace. value es el contacto completo nuevo; sin type, tiene que ser un email.
Solo se puede corregir lo que el workspace tipeó: un contacto que vino del proveedor, de un CV o de una planilla contesta NOT_FOUND. Si el valor nuevo ya lo tiene el workspace para esa persona, contesta CONTACT_ALREADY_KNOWN.
/actions/update_profile_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | string (uuid) | Sí | La persona. |
| contactId | string (uuid) | Sí | El id que devolvió add_profile_contact. |
| type | enum | Opcional | EMAIL_WORK, EMAIL_PERSONAL o PHONE. Sin type, el valor tiene que ser un email. |
| value | string | Sí | El valor completo nuevo. De 1 a 254 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/update_profile_contact \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"contactId": "c4e8b2a1-6d3f-4a9e-b7c5-1e2f3a4b5c6d",
"type": "PHONE",
"value": "+54 351 555 0124"
}'Respuesta
{
"data": {
"contactId": "c4e8b2a1-6d3f-4a9e-b7c5-1e2f3a4b5c6d",
"type": "PHONE"
},
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
}
],
"next": {
"missing": [],
"suggestions": [
{ "tool": "get_profile", "input": { "profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90" } }
]
}
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La persona no existe, o el contacto no es uno tipeado por el workspace. |
CONTACT_ALREADY_KNOWN | 409 | El workspace ya tiene ese valor para la persona. |
INVALID | 400 | El valor no es un email o teléfono válido. |
add_profile_tag
Familia: DO · No consume créditos.
Etiqueta a una o más personas del pool con la misma palabra, hasta 200 por llamada. Si el workspace nunca usó esa etiqueta, se crea. La coincidencia con las etiquetas existentes no distingue mayúsculas (el vocabulario se lee con GET /talent/tags/vocabulary). Si una etiqueta archivada tiene ese nombre, se reactiva. Que alguien ya tenga la etiqueta no es un error: la respuesta separa cuántos se etiquetaron ahora (tagged) y cuántos ya la tenían (already).
/actions/add_profile_tagBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | string[] (uuid) | Sí | Las personas. De 1 a 200. |
| name | string | Sí | La etiqueta. De 1 a 60 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/add_profile_tag \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"profileIds": [
"3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
],
"name": "Golang senior"
}'Respuesta
tag es el nombre tal como lo guarda el workspace (si ya existía con otras mayúsculas, vuelve el existente).
{
"data": { "tag": "Golang senior", "tagged": 1, "already": 1 },
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
},
{
"kind": "profile",
"id": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"label": "Martín Quiroga",
"href": "https://app.reclee.com/talent-pool?talent=7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | Con un solo id, esa persona no existe o el workspace no la puede ver. |
remove_profile_tag
Familia: DO · No consume créditos.
Le saca una etiqueta a una o más personas del pool, hasta 200 por llamada. El nombre no distingue mayúsculas. Quien no tenía la etiqueta queda igual: la respuesta dice cuántos la perdieron de verdad (removed). La etiqueta sigue existiendo en el workspace para el resto; para sacarla del vocabulario está update_tag.
/actions/remove_profile_tagBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | string[] (uuid) | Sí | Las personas. De 1 a 200. |
| name | string | Sí | La etiqueta. De 1 a 60 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/remove_profile_tag \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"profileIds": ["7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"],
"name": "golang senior"
}'Respuesta
{
"data": { "tag": "Golang senior", "removed": 1 },
"links": [
{
"kind": "profile",
"id": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"label": "Martín Quiroga",
"href": "https://app.reclee.com/talent-pool?talent=7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | El workspace nunca usó esa etiqueta, o (con un solo id) la persona no existe. |
update_tag
Familia: DO · No consume créditos.
Renombra o archiva una etiqueta del vocabulario del workspace: una de las dos cosas por llamada (mandar name y archived juntos, o ninguno, es INVALID). El tagId sale de GET /talent/tags o de la tool de lectura list_tags.
namela renombra para todas las personas que la tienen. Si otra etiqueta activa ya usa ese nombre, contestaNAME_TAKEN: las dos nunca se fusionan.archived: truela saca del vocabulario y de los filtros del pool; quien la tenía la conserva en su historia. Volver a etiquetar a alguien con ese nombre (add_profile_tag) la reactiva.
Las etiquetas no se borran por API: archivar es la alternativa.
/actions/update_tagBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| tagId | string (uuid) | Sí | La etiqueta. |
| name | string | Opcional | Nombre nuevo. De 1 a 60 caracteres. |
| archived | true | Opcional | Solo acepta true: archiva la etiqueta. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/update_tag \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"tagId": "9b1e7d3c-2a4f-4c8e-a6b5-0d9f8e7c6b5a",
"name": "Go senior"
}'Respuesta
{
"data": {
"tagId": "9b1e7d3c-2a4f-4c8e-a6b5-0d9f8e7c6b5a",
"name": "Go senior",
"archived": false
},
"links": []
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | Mandaste name y archived juntos, o ninguno de los dos. |
NAME_TAKEN | 409 | Otra etiqueta activa ya tiene ese nombre. |
NOT_FOUND | 404 | La etiqueta no existe en el workspace. |
set_profile_do_not_contact
Familia: DO · No consume créditos.
Marca a una o más personas del pool como «no contactar», hasta 200 por llamada, con una nota que explica por qué. La marca es de tu workspace: no afecta la relación de otro workspace con esas personas. Quien ya estaba marcado conserva la fecha y el motivo originales. La respuesta dice cuántos cambiaron de verdad (changed) y cuántos ya estaban marcados (unchanged).
Esta acción solo marca. Levantar una marca lo hace una persona desde la ficha en la app; no hay acción para eso.
/actions/set_profile_do_not_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | string[] (uuid) | Sí | Las personas. De 1 a 200. |
| note | string | Sí | El motivo. De 1 a 500 caracteres. |
| doNotContact | true | Opcional | Solo acepta true. Se puede omitir. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/set_profile_do_not_contact \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"profileIds": ["7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"],
"note": "Pidió por email que no lo volvamos a contactar."
}'Respuesta
{
"data": { "doNotContact": true, "changed": 1, "unchanged": 0 },
"links": [
{
"kind": "profile",
"id": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"label": "Martín Quiroga",
"href": "https://app.reclee.com/talent-pool?talent=7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | Con un solo id, esa persona no existe o el workspace no la puede ver. |
save_to_pool
Familia: DO · No consume créditos: lo que costó traer a esas personas ya se cobró en la búsqueda.
Guarda en el pool a personas que mostró una búsqueda de talento, hasta 200 por llamada. Una búsqueda solo muestra gente: nadie entra al pool hasta que lo guardas acá, lo agregas a una lista (add_to_bookmark) o a una vacante (add_to_job_post), que también lo guardan. Los profileIds salen de search_talent, load_more_talent o GET /talent/searches/{searchId}.
Guardar a alguien que ya estaba no es un error: saved cuenta a quienes entraron ahora y already a quienes ya estaban.
/actions/save_to_poolBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | string[] (uuid) | Sí | Las personas. De 1 a 200. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/save_to_pool \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"profileIds": [
"3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
]
}'Respuesta
{
"data": { "saved": 2, "already": 0 },
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
},
{
"kind": "profile",
"id": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"label": "Martín Quiroga",
"href": "https://app.reclee.com/talent-pool?talent=7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | Con un solo id, esa persona no existe o el workspace no la puede ver. |
remove_from_pool
Familia: DO · No consume créditos.
Saca personas del pool archivándolas, hasta 200 por llamada. El pool, sus filtros y los listados dejan de mostrarlas, pero no se borra nada: sus CVs, notas, etiquetas, listas, postulaciones, la marca de «no contactar» y el enriquecimiento ya pagado se conservan. Vuelven al pool por cualquier camino que las ponga de nuevo: enrich_profile, add_to_bookmark, add_to_job_post o save_to_pool.
data.archived cuenta a quienes efectivamente salieron, y links trae solo a esas personas.
/actions/remove_from_poolBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileIds | string[] (uuid) | Sí | Las personas. De 1 a 200. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/remove_from_pool \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"] }'Respuesta
{
"data": { "archived": 1 },
"links": [
{
"kind": "profile",
"id": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"label": "Martín Quiroga",
"href": "https://app.reclee.com/talent-pool?talent=7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOTHING_TO_REMOVE | 409 | Ninguna de las personas estaba en el pool. |
NOT_FOUND | 404 | Con un solo id, esa persona no existe o el workspace no la puede ver. |
resolve_merge_candidate
Familia: DO · No consume créditos.
Resuelve un posible duplicado del pool. Reclee detecta personas que podrían ser la misma (mismo email, mismo nombre, etc.) y las pone en una cola de revisión que se lee con GET /talent/pool/identity-reviews o la tool list_merge_candidates. Esta acción toma una de dos decisiones:
NOT_SAME_PERSON: cierra el casoreviewIdpara siempre. Son personas distintas y esa misma coincidencia no vuelve a la cola.MERGE(default): fusiona dos personas del pool que son la misma, solo dentro de tu workspace. Es una fusión suave: no se borra nada.
Cómo funciona el merge:
- Quién queda lo decide una regla, no el orden de
keepProfileIdymergeProfileId: queda la que tiene perfil de LinkedIn; si ninguna o ambas, la más antigua. La respuesta dice cuál quedó (keep) y cuál se fusionó (merged). - La otra apunta a la que queda y sale de las vistas del pool.
- Postulaciones, notas, etiquetas, listas, contactos (también los revelados), CVs y adjuntos pasan a la que queda.
- Si las dos se postularon a la misma vacante, gana la postulación con contratación; si no, la más avanzada; si no, la más antigua. La otra queda retirada.
- Se conserva la marca de «no contactar» de cualquiera de las dos.
- En un caso de tres o más personas, fusionar dos deja el caso abierto con el resto.
/actions/resolve_merge_candidateBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| decision | enum | Opcional | MERGE (default) o NOT_SAME_PERSON. |
| keepProfileId | string (uuid) | Opcional | Con MERGE, obligatorio: una de las dos personas. |
| mergeProfileId | string (uuid) | Opcional | Con MERGE, obligatorio y distinto de keepProfileId. |
| reviewId | string (uuid) | Opcional | Con NOT_SAME_PERSON, obligatorio: el caso de la cola de duplicados. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/resolve_merge_candidate \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"decision": "MERGE",
"keepProfileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"mergeProfileId": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}'Respuesta
Con MERGE, data cuenta cuánto se movió a la persona que quedó:
{
"data": {
"keep": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"merged": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"applications": 2,
"withdrawnApplications": 0,
"notes": 3,
"tags": 1,
"bookmarks": 1,
"contacts": 2,
"cvs": 1,
"attachments": 0,
"identityReviews": 1
},
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "Lucía Ferreyra",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
}
],
"next": {
"missing": [],
"suggestions": [
{ "tool": "get_profile", "input": { "profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90" } },
{ "tool": "list_merge_candidates" }
]
}
}Con NOT_SAME_PERSON:
{
"data": { "reviewId": "e2d4f6a8-1b3c-4d5e-8f7a-9b0c1d2e3f4a", "notSamePerson": true },
"links": [ "…una por cada persona del caso…" ],
"next": { "missing": [], "suggestions": [{ "tool": "list_merge_candidates" }] }
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | MERGE sin los dos ids (o con el mismo id dos veces), o NOT_SAME_PERSON sin reviewId. |
BOTH_HIRED | 409 | Las dos personas fueron contratadas en la misma vacante. |
TWO_PUBLIC_PROFILES | 409 | Cada una tiene su propio perfil de LinkedIn: son dos personas. |
NOT_FOUND | 404 | Alguna persona no está en el pool, o el caso ya se resolvió. |
upload_attachment
Familia: DO · No consume créditos ni uso, pero ocupa espacio de almacenamiento del workspace. Solo existe por API y MCP (no en el asistente de la app).
Adjunta un archivo a una persona del pool: un portfolio, un certificado, una oferta firmada. Para un CV usa upload_cv, que además lo lee.
El archivo no viaja en esta llamada, ni en base64 ni de ninguna otra forma: el body JSON de una acción admite como máximo 1 MB. Se sube en tres pasos, siempre con el mismo body:
Describe el archivo. Llama a la acción con profileId, fileName, size en bytes, type y el sha256 de sus bytes (hex en minúsculas, calculado del archivo, nunca inventado). La respuesta es status: "PENDING" con un uploadUrl firmado que vale dos horas.
Sube los bytes. Haz un PUT del archivo crudo (no multipart, no base64) a uploadUrl, con el Content-Type igual al type que declaraste. Ese PUT va directo al almacenamiento y no lleva tu API key.
Confirma. Llama de nuevo a la acción con el mismo body. Reclee lee lo que llegó, verifica tipo, tamaño y sha256, y contesta status: "READY". Si todavía no llegó nada, vuelve a contestar PENDING con un uploadUrl nuevo.
Mientras la respuesta sea PENDING, next sugiere repetir la misma acción. Si usas Idempotency-Key, la segunda llamada necesita una key nueva: con la misma key, el servidor repite la primera respuesta (PENDING).
Si la persona ya tiene ese mismo archivo (mismo sha256 y tamaño), la primera llamada contesta directamente READY con alreadyHere: true y no hay que subir nada. Por eso un sha256 equivocado puede apuntar a otro archivo: calcúlalo siempre del archivo real.
Tipos aceptados: PDF, DOCX, XLSX, PNG, JPEG y WebP, hasta 10 MB. El espacio para adjuntos del workspace tiene un límite: cada subida no confirmada cuenta como 10 MB hasta que se confirma. Los adjuntos de una persona aparecen en la lectura get_profile (por MCP), y la URL de descarga de cada uno se pide con GET /talent/pool/attachments/{attachmentId}/url. Ninguna acción borra un adjunto.
/actions/upload_attachmentBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileId | string (uuid) | Sí | La persona. |
| applicationId | string (uuid) | Opcional | Si el archivo pertenece a una de sus postulaciones. |
| fileName | string | Sí | Nombre del archivo. De 1 a 255 caracteres. |
| size | integer | Sí | Tamaño en bytes. De 1 a 10485760 (10 MB). |
| type | enum | Sí | application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, image/png, image/jpeg o image/webp. |
| sha256 | string | Sí | SHA-256 de los bytes, 64 caracteres hex en minúsculas. |
Ejemplo
FILE=portfolio.pdf
SIZE=$(wc -c < "$FILE" | tr -d ' ')
SHA=$(sha256sum "$FILE" | cut -d' ' -f1)
BODY=$(printf '{"profileId":"3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90","fileName":"%s","size":%s,"type":"application/pdf","sha256":"%s"}' "$FILE" "$SIZE" "$SHA")
# 1. Describir el archivo
curl -X POST https://app.reclee.com/api/v1/actions/upload_attachment \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d "$BODY"
# → { "data": { "status": "PENDING", "uploadUrl": "https://…", ... } }
# 2. Subir los bytes a uploadUrl
curl -X PUT "<uploadUrl>" \
-H "Content-Type: application/pdf" \
--data-binary @"$FILE"
# 3. Confirmar con el mismo body
curl -X POST https://app.reclee.com/api/v1/actions/upload_attachment \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d "$BODY"Respuesta
Primera llamada:
{
"data": {
"attachmentId": "5d7f9b1c-3e5a-4c7e-9a1b-2c3d4e5f6a7b",
"status": "PENDING",
"uploadUrl": "https://storage.example/upload/sign/…?token=…",
"alreadyHere": false
},
"links": [
{
"kind": "profile",
"id": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"label": "portfolio.pdf",
"href": "https://app.reclee.com/talent-pool?talent=3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90"
}
],
"next": { "missing": [], "suggestions": [{ "tool": "upload_attachment" }] }
}Segunda llamada, con los bytes ya subidos:
{
"data": {
"attachmentId": "5d7f9b1c-3e5a-4c7e-9a1b-2c3d4e5f6a7b",
"status": "READY",
"uploadUrl": null,
"alreadyHere": false
},
"links": [ "…" ],
"next": {
"missing": [],
"suggestions": [
{ "tool": "get_profile", "input": { "profileId": "3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90" } }
]
}
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | La descripción no pasa el schema: tipo fuera de la lista, más de 10 MB, nombre vacío, sha256 que no es hex en minúsculas. |
BAD_FILE | 400 | Los bytes que llegaron no coinciden con el tipo, Content-Type, tamaño o sha256 declarados (la subida se descarta: empieza de nuevo), o el sha256 pertenece a un archivo de otro tamaño. |
TOO_LARGE | 413 | El archivo supera el máximo. |
LIMIT_REACHED | 409 | El espacio para adjuntos del workspace está lleno. Lo liberan o amplían las personas OWNER del workspace (suggestions sugiere list_members para encontrarlas). |
NOT_FOUND | 404 | La persona (o la postulación) no está en el workspace. |
upload_cv
Familia: PROVIDER · Consume uso de IA: cada CV que llega se lee con un modelo. Solo existe por API y MCP (no en el asistente de la app).
Abre una subida de hasta 100 CVs al talent pool. Cada CV se lee y se convierte en una persona del pool (nueva, o una versión nueva del perfil propio de alguien que ya estaba). Igual que upload_attachment, los archivos no viajan en esta llamada (no los mandes en base64: el body JSON admite como máximo 1 MB):
Describe la lista. Manda files, cada uno con name, size en bytes (hasta 4 MB), type (PDF o DOCX) y el sha256 de sus bytes en hex minúsculas.
Sube cada archivo. La respuesta trae un uploadUrl firmado por archivo, válido dos horas. Haz un PUT de los bytes crudos a cada URL con Content-Type igual a su type. Un archivo que a las dos horas no llegó queda fallido.
Sigue el progreso. No hace falta confirmar: apenas llega un archivo, la cola lo lee sola (unos minutos para cien). Consulta GET /talent/pool/cvs/jobs/{jobId} (o la tool de lectura get_cv_import con el jobId) hasta que finished sea true.
Un archivo cuyo sha256 el workspace ya tiene vuelve con uploadUrl: null y alreadyHere: true: no se sube, no se lee y no se cobra de nuevo. Por eso reenviar una subida cortada completa es seguro: solo se sube lo que falta.
Opciones:
profileIdarchiva todos los CVs bajo esa persona, en lugar de la que nombre cada CV.linkPublicProfile: trueademás vincula el perfil público de LinkedIn de quien nombra cada CV (cuando el CV trae un LinkedIn). Cada vínculo consume uso. Sin ese campo, no se vincula.
Costo. Leer cada CV consume uso de IA del workspace. El gasto se registra a medida que la cola lee los archivos, por eso el campo cost de la respuesta viene con billedLater: true y no refleja la lectura completa. Si el plan se queda sin margen mientras se procesa, los archivos esperan (waitingFor en el progreso) y se leen cuando vuelve a haber. Para ver el margen antes de subir, usa GET /billing/usage-standing (Créditos y uso).
/actions/upload_cvBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| files | object[] | Sí | Los archivos. De 1 a 100. |
| files[].name | string | Sí | Nombre del archivo. De 1 a 500 caracteres. |
| files[].size | integer | Sí | Tamaño en bytes. De 1 a 4194304 (4 MB). |
| files[].type | enum | Sí | application/pdf o application/vnd.openxmlformats-officedocument.wordprocessingml.document. |
| files[].sha256 | string | Sí | SHA-256 de los bytes, 64 caracteres hex en minúsculas. |
| profileId | string (uuid) | Opcional | Archiva todos los CVs bajo esta persona. |
| linkPublicProfile | boolean | Opcional | true vincula además el perfil público de quien nombra cada CV. Consume uso por vínculo. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/upload_cv \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6c1f0d2e-cv-batch-0142" \
-d '{
"files": [
{
"name": "cv-lucia-ferreyra.pdf",
"size": 184320,
"type": "application/pdf",
"sha256": "9f2b5c1e7a4d3b8c0e6f1a2d4b7c9e0f3a5d8b1c4e7f0a2d5b8c1e4f7a0d3b6c"
},
{
"name": "cv-martin-quiroga.docx",
"size": 96512,
"type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"sha256": "1c4e7f0a2d5b8c1e4f7a0d3b6c9f2b5c1e7a4d3b8c0e6f1a2d4b7c9e0f3a5d8b"
}
]
}'
# Después, por cada archivo con uploadUrl:
curl -X PUT "<uploadUrl>" \
-H "Content-Type: application/pdf" \
--data-binary @cv-lucia-ferreyra.pdfRespuesta
{
"data": {
"jobId": "1a3c5e7f-9b2d-4f6a-8c0e-2b4d6f8a0c1e",
"files": [
{
"position": 0,
"fileName": "cv-lucia-ferreyra.pdf",
"uploadUrl": "https://storage.example/upload/sign/…?token=…",
"alreadyHere": false,
"profileId": null
},
{
"position": 1,
"fileName": "cv-martin-quiroga.docx",
"uploadUrl": null,
"alreadyHere": true,
"profileId": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
]
},
"links": [
{
"kind": "profile",
"id": "7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13",
"label": "cv-martin-quiroga.docx",
"href": "https://app.reclee.com/talent-pool?talent=7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
}
],
"next": {
"missing": [],
"suggestions": [
{ "tool": "get_cv_import", "input": { "jobId": "1a3c5e7f-9b2d-4f6a-8c0e-2b4d6f8a0c1e" } }
]
},
"cost": { "aiUsagePct": 0, "teamUsagePct": 0, "credits": 0, "billedLater": true }
}Seguir el progreso
Por MCP, la tool get_cv_import con { "jobId": "…" } devuelve, entre otros: finished, total, done, failed, created (personas nuevas), exists (personas que ya estaban: su CV entra como versión nueva), noIdentifier (CVs sin un email ni un LinkedIn para identificar a nadie), alreadyHere, waitingFor (el código de límite de uso que tiene a los archivos esperando, o null), failures (archivo y error) y people (archivo, resultado, profileId y un posible duplicado). Por REST, GET /talent/pool/cvs/jobs/{jobId} devuelve el mismo progreso con el detalle de cada archivo.
Errores
| Código | HTTP | Cuándo |
|---|---|---|
BAD_FILE | 400 | Algún archivo no es de un tipo o tamaño que se pueda leer. |
TOO_MANY | 429 | Ya tienes tantos CVs en camino como admite la cola. Espera a que avancen. |
USAGE_WINDOW | 402 | Se alcanzó el límite de uso de las últimas cinco horas; vuelve más tarde. |
USAGE_EXHAUSTED | 402 | Se terminó el uso de IA del mes. |
SEAT_REQUIRED | 403 | La persona de la key no tiene asiento. |