Listas
Acciones para crear, compartir y borrar listas de personas del talent pool, y para agregar o sacar personas de ellas.
Una lista (en la app, «lista»; en la API, bookmark) agrupa personas del talent pool bajo un nombre: «Finalistas backend Q4», «Diseñadoras para Andes Pay», «Referidos de Lucía». Una persona puede estar en muchas listas, y sacarla de una lista no la saca del pool.
Cada lista tiene una dueña: quien la creó. Nace privada (solo la ve su dueña) y se comparte con todo el workspace con set_bookmark_visibility. Solo la dueña puede renombrarla, cambiar su visibilidad o borrarla; cualquier persona que pueda verla puede agregarle o sacarle gente. Una lista privada de otra persona es invisible para el resto, no de solo lectura.
Los bookmarkId salen de GET /talent/bookmarks (o de la tool de lectura list_bookmarks, cuyo campo isOwn dice si eres la dueña) y de la respuesta de create_bookmark. Agregar a una lista también guarda a la persona en el pool: es una de las formas de conservar a alguien que trajo una búsqueda de talento.
Cómo se llama una acción
POST https://app.reclee.com/api/v1/actions/<nombre> con body JSON y Authorization: Bearer rcl_…. La respuesta trae data y links (la URL absoluta de la lista en la app). Ninguna acción de esta página consume créditos ni uso. Los errores comunes están en Errores.
create_bookmark
Familia: DO · No consume créditos.
Crea una lista nueva en el workspace. Quien llama queda como dueña (no es un parámetro) y la lista siempre nace privada; compartirla es un paso aparte con set_bookmark_visibility.
/actions/create_bookmarkBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre de la lista. De 1 a 80 caracteres. |
| description | string | null | Opcional | Descripción. Máximo 280 caracteres. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/create_bookmark \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Finalistas backend Q4",
"description": "Perfiles Go para la búsqueda de Andes Pay"
}'Respuesta
{
"data": { "bookmarkId": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f" },
"links": [
{
"kind": "bookmark",
"id": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"label": "Finalistas backend Q4",
"href": "https://app.reclee.com/talent-pool?bookmark=b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f"
}
]
}Errores
Solo los comunes a todas las acciones (por ejemplo INVALID si el nombre está vacío o es demasiado largo).
update_bookmark
Familia: DO · No consume créditos.
Renombra una lista o cambia su descripción. Solo la dueña puede hacerlo. Hace falta al menos name o description; description: null la vacía. No cambia quién puede ver la lista: para eso está set_bookmark_visibility.
/actions/update_bookmarkBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | string (uuid) | Sí | La lista. |
| name | string | Opcional | Nombre nuevo. De 1 a 80 caracteres. |
| description | string | null | Opcional | Descripción nueva. Máximo 280 caracteres. null la vacía. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/update_bookmark \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"bookmarkId": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"name": "Finalistas backend — Andes Pay",
"description": null
}'Respuesta
{
"data": { "name": "Finalistas backend — Andes Pay", "description": null },
"links": [
{
"kind": "bookmark",
"id": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"label": "Finalistas backend Q4",
"href": "https://app.reclee.com/talent-pool?bookmark=b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_BOOKMARK_OWNER | 403 | Quien llama no es la dueña de la lista. |
NOT_FOUND | 404 | La lista no existe o no la puedes ver. |
INVALID | 400 | No mandaste ni name ni description. |
delete_bookmark
Familia: DO · No consume créditos.
Borra una lista para siempre, sin deshacer. Es una de las pocas acciones de la API que borra algo. Las personas que estaban en la lista siguen en el pool: solo desaparecen la lista y quién estaba archivado en ella. Solo la dueña puede borrarla.
/actions/delete_bookmarkBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | string (uuid) | Sí | La lista. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/delete_bookmark \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "bookmarkId": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f" }'Respuesta
{
"data": { "deleted": true },
"links": [
{
"kind": "bookmark",
"id": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"label": "Finalistas backend Q4",
"href": "https://app.reclee.com/talent-pool?bookmark=b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_BOOKMARK_OWNER | 403 | Quien llama no es la dueña de la lista. |
NOT_FOUND | 404 | La lista no existe o no la puedes ver. |
set_bookmark_visibility
Familia: DO · No consume créditos.
Comparte una lista con todo el workspace o la vuelve privada. Solo la dueña puede cambiarlo. isPrivate: true la deja visible solo para su dueña; false la comparte.
/actions/set_bookmark_visibilityBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | string (uuid) | Sí | La lista. |
| isPrivate | boolean | Sí | true: solo la ve su dueña. false: la ve todo el workspace. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/set_bookmark_visibility \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "bookmarkId": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f", "isPrivate": false }'Respuesta
{
"data": { "isPrivate": false },
"links": [
{
"kind": "bookmark",
"id": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"label": "Finalistas backend Q4",
"href": "https://app.reclee.com/talent-pool?bookmark=b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_BOOKMARK_OWNER | 403 | Quien llama no es la dueña de la lista. |
NOT_FOUND | 404 | La lista no existe o no la puedes ver. |
add_to_bookmark
Familia: DO · No consume créditos.
Agrega una o más personas a una lista, hasta 500 por llamada. Cualquiera que pueda ver la lista puede agregar, sea o no la dueña. Solo entran personas que tu workspace conserva (en el pool o traídas por una búsqueda); el resto se saltea, y si ninguna califica la acción contesta NOT_FOUND. Quien ya estaba en la lista se saltea sin error: added cuenta solo a las personas que entraron ahora.
/actions/add_to_bookmarkBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | string (uuid) | Sí | La lista. |
| profileIds | string[] (uuid) | Sí | Las personas. De 1 a 500. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/add_to_bookmark \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"bookmarkId": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"profileIds": [
"3f6c1a2e-8b4d-4e1f-9a7c-2d5e8f1b4c90",
"7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"
]
}'Respuesta
{
"data": { "added": 2 },
"links": [
{
"kind": "bookmark",
"id": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"label": "Finalistas backend Q4",
"href": "https://app.reclee.com/talent-pool?bookmark=b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La lista no existe o no la puedes ver, o ninguna de las personas está en el workspace. |
remove_from_bookmark
Familia: DO · No consume créditos.
Saca una o más personas de una lista, hasta 500 por llamada. El pool las conserva: solo la lista se olvida de ellas. Cualquiera que pueda ver la lista puede sacar gente. Quien no estaba en la lista se saltea sin error: removed cuenta a las personas que efectivamente salieron.
/actions/remove_from_bookmarkBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | string (uuid) | Sí | La lista. |
| profileIds | string[] (uuid) | Sí | Las personas. De 1 a 500. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/remove_from_bookmark \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"bookmarkId": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"profileIds": ["7a2d9e4b-1c3f-4b8a-8e6d-5f0a2b7c9d13"]
}'Respuesta
{
"data": { "removed": 1 },
"links": [
{
"kind": "bookmark",
"id": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"label": "Finalistas backend Q4",
"href": "https://app.reclee.com/talent-pool?bookmark=b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f"
}
]
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La lista no existe o no la puedes ver. |
add_longlist_to_bookmark
Familia: DO · No consume créditos.
Agrega de una sola vez a todas las personas de una longlist cerrada a una lista. Una longlist es el resultado de una corrida de sourcing; los ids de la vacante y de la longlist salen de GET /sourcing/longlists?jobPostId=… (o de la tool list_longlists). Una corrida todavía abierta no tiene a nadie adentro y contesta NOT_FOUND. Quien ya estaba en la lista se saltea; added cuenta a quienes entraron ahora.
/actions/add_longlist_to_bookmarkBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| bookmarkId | string (uuid) | Sí | La lista. |
| jobPostId | string (uuid) | Sí | La vacante de la longlist. |
| longlistId | string (uuid) | Sí | La longlist, cerrada. |
Ejemplo
curl -X POST https://app.reclee.com/api/v1/actions/add_longlist_to_bookmark \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"bookmarkId": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"jobPostId": "2e4a6c8d-0f1b-4d3e-a5c7-9e1b3d5f7a90",
"longlistId": "6f8a0c2e-4b6d-4f8a-9c1e-3a5c7e9b1d2f"
}'Respuesta
{
"data": { "added": 47 },
"links": [
{
"kind": "bookmark",
"id": "b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f",
"label": "Finalistas backend Q4",
"href": "https://app.reclee.com/talent-pool?bookmark=b3d5f7a9-1c2e-4b4d-8f6a-0c2e4a6b8d9f"
},
{
"kind": "longlist",
"id": "6f8a0c2e-4b6d-4f8a-9c1e-3a5c7e9b1d2f",
"label": "Backend Go · LATAM",
"href": "https://app.reclee.com/job-posts/2e4a6c8d-0f1b-4d3e-a5c7-9e1b3d5f7a90/sourcing?tab=longlists&list=6f8a0c2e-4b6d-4f8a-9c1e-3a5c7e9b1d2f"
}
],
"next": { "missing": [], "suggestions": [{ "tool": "list_bookmarks" }] }
}Errores
| Código | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La lista o la longlist no existen, la longlist no es de esa vacante, o la corrida sigue abierta. |