Reclee

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.

POST/actions/create_profile

Body

CampoTipoRequeridoDescripción
namestringSíNombre completo. De 1 a 200 caracteres.
emailstring (email)OpcionalEmail de la persona. Máximo 320 caracteres. Hace falta email o linkedin.
linkedinstringOpcionalURL del perfil de LinkedIn de la persona (linkedin.com/in/…). Máximo 300 caracteres. Hace falta email o linkedin.
phonestringOpcionalTeléfono. Máximo 40 caracteres.
headlinestringOpcionalTitular (la línea debajo del nombre). Máximo 200 caracteres.
titlestringOpcionalCargo actual. Máximo 200 caracteres. Obligatorio si mandas company.
companystringOpcionalEmpresa actual. Máximo 200 caracteres.
locationstringOpcionalUbicación. Máximo 200 caracteres.
summarystringOpcionalResumen. Máximo 4000 caracteres.
skillsstring[]OpcionalSkills. 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ódigoHTTPCuándo
INVALID400Falta email y linkedin, hay company sin title, o linkedin no es el perfil de una persona. details dice qué campo.
PROFILE_INVALID400Los 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:

  • null vacía un campo de texto.
  • languages y skills reemplazan la lista entera: manda la lista completa que quieres.
  • La carrera nunca se manda entera. addPositions, addEducation, addCertifications y addProjects agregan entradas; removePositions, removeEducation, removeCertifications y removeProjects sacan 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 lleva isCurrent: true y no lleva endYear.
  • baseVersion es obligatorio: es la versión propia sobre la que calculaste los índices, o null si el workspace nunca escribió una. Léela antes: es la versión más nueva de GET /talent/pool/{profileId}/own, o ownProfileVersion en la tool de lectura get_profile por MCP (que además trae ownCareer con los índices). Si mientras tanto alguien guardó otra versión, la acción contesta PROFILE_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.

POST/actions/update_profile

Body

CampoTipoRequeridoDescripción
profileIdstring (uuid)SíLa persona.
baseVersioninteger | nullSíVersión propia actual (mínimo 1), o null si nunca se escribió una.
headlinestring | nullOpcionalTitular. Máximo 200 caracteres. null lo vacía.
locationstring | nullOpcionalUbicación. Máximo 200 caracteres.
summarystring | nullOpcionalResumen. Máximo 4000 caracteres.
verifiedLanguagesstring | nullOpcionalIdiomas que alguien del equipo verificó, en texto libre. Máximo 400 caracteres.
languagesstring[]OpcionalReemplaza la lista. Hasta 20, de 1 a 80 caracteres cada uno.
skillsstring[]OpcionalReemplaza la lista. Hasta 60, de 1 a 80 caracteres cada una.
addPositionsobject[]OpcionalPuestos a agregar (hasta 30).
addPositions[].titlestringSíCargo. De 1 a 200 caracteres.
addPositions[].organizationNamestringSíEmpresa. De 1 a 200 caracteres.
addPositions[].descriptionstringOpcionalMáximo 2000 caracteres.
addPositions[].isCurrentbooleanOpcionalPuesto vigente. Default false.
addPositions[].startYear / endYearintegerOpcionalEntre 1900 y 2100.
addPositions[].startMonth / endMonthintegerOpcionalEntre 1 y 12.
removePositionsinteger[]OpcionalÍndices (desde 0) de puestos a sacar. Hasta 30.
addEducationobject[]OpcionalEstudios a agregar (hasta 20).
addEducation[].schoolNamestringSíInstitución. De 1 a 200 caracteres.
addEducation[].degreestringOpcionalTítulo. Máximo 200 caracteres.
addEducation[].fieldOfStudystringOpcionalÁrea. Máximo 200 caracteres.
addEducation[].startYear / endYearintegerOpcionalEntre 1900 y 2100.
removeEducationinteger[]OpcionalÍndices de estudios a sacar. Hasta 20.
addCertificationsobject[]OpcionalCertificaciones a agregar (hasta 30).
addCertifications[].namestringSíDe 1 a 200 caracteres.
addCertifications[].authoritystringOpcionalQuién la emite. Máximo 200 caracteres.
addCertifications[].urlstringOpcionalMáximo 500 caracteres.
addCertifications[].issuedYearintegerOpcionalEntre 1900 y 2100.
removeCertificationsinteger[]OpcionalÍndices de certificaciones a sacar. Hasta 30.
addProjectsobject[]OpcionalProyectos a agregar (hasta 20).
addProjects[].namestringSíDe 1 a 200 caracteres.
addProjects[].descriptionstringOpcionalMáximo 2000 caracteres.
addProjects[].urlstring (uri)Opcionalhttp o https. Máximo 500 caracteres.
addProjects[].isCurrentbooleanOpcionalProyecto vigente. Default false.
addProjects[].startYear / endYearintegerOpcionalEntre 1900 y 2100.
addProjects[].startMonth / endMonthintegerOpcionalEntre 1 y 12.
removeProjectsinteger[]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ódigoHTTPCuándo
PROFILE_CHANGED409Otra versión se guardó después de baseVersion. Lee de nuevo y rehaz el cambio.
CAREER_ENTRY_NOT_FOUND404Un índice de remove… no existe en la carrera propia actual.
CAREER_TOO_LONG400Una lista superaría su tope (30 puestos, 20 estudios, 30 certificaciones, 20 proyectos).
NOTHING_TO_CHANGE409La llamada no cambiaría nada.
PROFILE_INVALID400La versión resultante no es válida.
NOT_FOUND404La 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.

POST/actions/add_profile_contact

Body

CampoTipoRequeridoDescripción
profileIdstring (uuid)SíLa persona.
typeenumOpcionalEMAIL_WORK, EMAIL_PERSONAL o PHONE. Sin type, el valor tiene que ser un email.
valuestringSí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ódigoHTTPCuándo
INVALID400El valor no es un email válido (sin type o con un tipo de email) o no parece un teléfono.
NOT_FOUND404La 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.

POST/actions/update_profile_contact

Body

CampoTipoRequeridoDescripción
profileIdstring (uuid)SíLa persona.
contactIdstring (uuid)SíEl id que devolvió add_profile_contact.
typeenumOpcionalEMAIL_WORK, EMAIL_PERSONAL o PHONE. Sin type, el valor tiene que ser un email.
valuestringSí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ódigoHTTPCuándo
NOT_FOUND404La persona no existe, o el contacto no es uno tipeado por el workspace.
CONTACT_ALREADY_KNOWN409El workspace ya tiene ese valor para la persona.
INVALID400El 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).

POST/actions/add_profile_tag

Body

CampoTipoRequeridoDescripción
profileIdsstring[] (uuid)SíLas personas. De 1 a 200.
namestringSí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ódigoHTTPCuándo
NOT_FOUND404Con 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.

POST/actions/remove_profile_tag

Body

CampoTipoRequeridoDescripción
profileIdsstring[] (uuid)SíLas personas. De 1 a 200.
namestringSí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ódigoHTTPCuándo
NOT_FOUND404El 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.

  • name la renombra para todas las personas que la tienen. Si otra etiqueta activa ya usa ese nombre, contesta NAME_TAKEN: las dos nunca se fusionan.
  • archived: true la 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.

POST/actions/update_tag

Body

CampoTipoRequeridoDescripción
tagIdstring (uuid)SíLa etiqueta.
namestringOpcionalNombre nuevo. De 1 a 60 caracteres.
archivedtrueOpcionalSolo 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ódigoHTTPCuándo
INVALID400Mandaste name y archived juntos, o ninguno de los dos.
NAME_TAKEN409Otra etiqueta activa ya tiene ese nombre.
NOT_FOUND404La 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.

POST/actions/set_profile_do_not_contact

Body

CampoTipoRequeridoDescripción
profileIdsstring[] (uuid)SíLas personas. De 1 a 200.
notestringSíEl motivo. De 1 a 500 caracteres.
doNotContacttrueOpcionalSolo 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ódigoHTTPCuándo
NOT_FOUND404Con 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.

POST/actions/save_to_pool

Body

CampoTipoRequeridoDescripción
profileIdsstring[] (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ódigoHTTPCuándo
NOT_FOUND404Con 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.

POST/actions/remove_from_pool

Body

CampoTipoRequeridoDescripción
profileIdsstring[] (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ódigoHTTPCuándo
NOTHING_TO_REMOVE409Ninguna de las personas estaba en el pool.
NOT_FOUND404Con 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 caso reviewId para 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 keepProfileId y mergeProfileId: 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.
POST/actions/resolve_merge_candidate

Body

CampoTipoRequeridoDescripción
decisionenumOpcionalMERGE (default) o NOT_SAME_PERSON.
keepProfileIdstring (uuid)OpcionalCon MERGE, obligatorio: una de las dos personas.
mergeProfileIdstring (uuid)OpcionalCon MERGE, obligatorio y distinto de keepProfileId.
reviewIdstring (uuid)OpcionalCon 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ódigoHTTPCuándo
INVALID400MERGE sin los dos ids (o con el mismo id dos veces), o NOT_SAME_PERSON sin reviewId.
BOTH_HIRED409Las dos personas fueron contratadas en la misma vacante.
TWO_PUBLIC_PROFILES409Cada una tiene su propio perfil de LinkedIn: son dos personas.
NOT_FOUND404Alguna 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.

POST/actions/upload_attachment

Body

CampoTipoRequeridoDescripción
profileIdstring (uuid)SíLa persona.
applicationIdstring (uuid)OpcionalSi el archivo pertenece a una de sus postulaciones.
fileNamestringSíNombre del archivo. De 1 a 255 caracteres.
sizeintegerSíTamaño en bytes. De 1 a 10485760 (10 MB).
typeenumSíapplication/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, image/png, image/jpeg o image/webp.
sha256stringSí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ódigoHTTPCuándo
INVALID400La 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_FILE400Los 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_LARGE413El archivo supera el máximo.
LIMIT_REACHED409El espacio para adjuntos del workspace está lleno. Lo liberan o amplían las personas OWNER del workspace (suggestions sugiere list_members para encontrarlas).
NOT_FOUND404La 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:

  • profileId archiva todos los CVs bajo esa persona, en lugar de la que nombre cada CV.
  • linkPublicProfile: true ademá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).

POST/actions/upload_cv

Body

CampoTipoRequeridoDescripción
filesobject[]SíLos archivos. De 1 a 100.
files[].namestringSíNombre del archivo. De 1 a 500 caracteres.
files[].sizeintegerSíTamaño en bytes. De 1 a 4194304 (4 MB).
files[].typeenumSíapplication/pdf o application/vnd.openxmlformats-officedocument.wordprocessingml.document.
files[].sha256stringSíSHA-256 de los bytes, 64 caracteres hex en minúsculas.
profileIdstring (uuid)OpcionalArchiva todos los CVs bajo esta persona.
linkPublicProfilebooleanOpcionaltrue 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.pdf

Respuesta

{
  "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ódigoHTTPCuándo
BAD_FILE400Algún archivo no es de un tipo o tamaño que se pueda leer.
TOO_MANY429Ya tienes tantos CVs en camino como admite la cola. Espera a que avancen.
USAGE_WINDOW402Se alcanzó el límite de uso de las últimas cinco horas; vuelve más tarde.
USAGE_EXHAUSTED402Se terminó el uso de IA del mes.
SEAT_REQUIRED403La persona de la key no tiene asiento.

En esta página