Borrados
Por qué la API casi nunca borra, qué contesta un DELETE reemplazado y qué DELETE sí existen.
La API y el servidor MCP no borran lo que tiene historia: una empresa, un candidato, una nota o una vacante en la que se trabajó se archivan, se cierran o se corrigen. Esta página explica la regla, qué contesta un DELETE que no se permite y cuáles sí existen.
Por qué
En reclutamiento, la historia importa: quién estuvo en qué proceso, qué se le dijo a un cliente, por qué se cerró una búsqueda. Un borrado por API no se puede deshacer, y un script con un error o un agente que entendió mal un pedido podría llevarse meses de trabajo sin dejar rastro. Por eso, fuera de la configuración de la cuenta y de unas pocas excepciones, lo que se deja de usar:
- se archiva: deja de aparecer, pero su historia queda (empresas, contactos, requests, tags, etiquetas, personas del talent pool);
- se cierra con su motivo: vacantes, perfiles ideales de sourcing;
- se corrige: una nota, un comentario, una pregunta o un contacto cargado a mano se editan;
- se cancela o se revisa: una entrevista se cancela, una respuesta de screening se revisa con su motivo.
Borrar de verdad lo hace una persona desde la app.
El 405 DELETE_NOT_ALLOWED
Un DELETE sobre algo que la API no borra contesta 405 con el código DELETE_NOT_ALLOWED, los métodos que la ruta sí acepta y la acción que hace lo que buscabas:
curl -X DELETE https://app.reclee.com/api/v1/crm/leads/5b2e8d14-7c3a-4f6e-9b1d-2a4c6e8f0b13 \
-H "Authorization: Bearer $RECLEE_API_KEY"HTTP/1.1 405 Method Not Allowed
Allow: GET, PATCH
{
"error": "DELETE_NOT_ALLOWED",
"allowed": ["GET", "PATCH"],
"suggestions": [{ "tool": "archive_lead" }]
}La acción sugerida se ejecuta con POST /actions/<tool>:
curl -X POST https://app.reclee.com/api/v1/actions/archive_lead \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "leadId": "5b2e8d14-7c3a-4f6e-9b1d-2a4c6e8f0b13" }'DELETE reemplazados
DELETE | Contesta 405 y sugiere | Qué hace la acción |
|---|---|---|
/crm/leads/{leadId} | archive_lead | Archiva la empresa junto con sus requests abiertos (o la restaura). |
/crm/contacts/{contactId} | archive_contact | Archiva el contacto. |
/crm/requests/{requestId} | archive_request | Archiva el request. |
/crm/activity/{activityId} | update_lead_activity | Corrige la entrada de actividad. |
/crm/contact-history/{entryId} | add_contact_history | Corrige (o agrega) una entrada del historial laboral del contacto. |
/talent/pool | remove_from_pool | Saca personas del talent pool (las archiva para el workspace). |
/talent/pool/{profileId} | remove_from_pool | Igual, para una persona. |
/talent/pool/{profileId}/contacts/{contactId} | update_profile_contact | Corrige un contacto cargado a mano. |
/talent/notes/{noteId} | update_note | Corrige la nota de un perfil. |
/talent/tags/{tagId} | update_tag | Renombra o archiva el tag. |
/job-posts/{jobPostId}/notes/{noteId} | update_note | Corrige la nota de una vacante. |
/sourcing/talent-icps/{talentIcpId} | close_talent_icp | Cierra el perfil ideal. |
/ats/comments/{commentId} | update_application_comment | Corrige el comentario. |
/ats/interviews/{interviewId} | update_interview | Edita o cancela la entrevista. |
/ats/labels/{labelId} | update_label | Renombra o archiva la etiqueta. |
/ats/questions/{questionId} | update_interview_question | Edita o descarta la pregunta. |
/ats/applications/{applicationId}/screening/{answerId} | review_screening_answer | Revisa la respuesta de screening con su motivo. |
El no contactar tampoco se levanta por API: se marca con una acción y solo una persona lo quita desde la app.
DELETE que sí existen
Estos DELETE existen porque no destruyen historia: deshacen un estado, desvinculan dos cosas que siguen existiendo, o son una excepción acotada. Casi todos funcionan con una API key; los tres de facturación y del borrado del workspace exigen al OWNER en persona en la app.
Deshacen un estado
DELETE | Qué hace |
|---|---|
/notifications/{notificationId}/read | Marca la notificación como no leída. |
/job-posts/{jobPostId}/shares/{shareId} | Revoca el link de shortlist. Queda registrado como revocado y no se reactiva. |
/talent/pool/identity-reviews/{reviewId} | Cierra un caso de posibles duplicados sin fusionar: «no son la misma persona». |
/ats/questions/{questionId}/answer | Quita la respuesta de una pregunta de entrevista; la pregunta queda sin responder. |
/account/workspace/deletion | Cancela el borrado programado del workspace. Solo el OWNER en persona en la app: con una API key contesta 403. |
/billing/plan | Cancela un cambio de plan que todavía no ocurrió. Solo el OWNER en persona: con una API key contesta 403. |
/billing/cancellation | Retira la cancelación de la suscripción antes de que termine el período. Solo el OWNER en persona: con una API key contesta 403. |
Desvinculan
DELETE | Qué hace |
|---|---|
/ats/applications/{applicationId}/labels/{labelId} | Le quita una etiqueta a una postulación. Contesta 204. |
/profiles/{profileId}/tags/{tagId} | Le quita un tag a un perfil. Contesta 204. |
/talent/pool/tags | Le quita un tag a varios perfiles a la vez. Cuerpo: { "profileIds": [...], "name": "..." } (hasta 500 ids); contesta cuántos se quitaron. |
/talent/bookmarks/{bookmarkId}/profiles | Saca perfiles de una lista. Cuerpo: { "profileIds": [...] } (hasta 500); contesta cuántos salieron. Las personas siguen en el pool. |
/job-posts/{jobPostId}/members/{memberId} | Saca a alguien del equipo de una vacante. Contesta 204. |
/job-posts/{jobPostId}/subscriptions/{memberId} | Quita a alguien de los suscriptores de una vacante. Contesta 204. |
Excepciones acotadas
DELETE | Qué hace |
|---|---|
/job-posts/{jobPostId} | Borra solo un borrador en el que nadie trabajó: sin candidatos, sin corridas de sourcing y sin búsquedas pagadas. Cualquier otra vacante contesta 409 JOB_POST_NOT_DELETABLE y sugiere close_job_post. |
/talent/bookmarks/{bookmarkId} | Borra una lista. Las personas siguen en el pool. |
/sourcing/search-definitions/{definitionId} | Borra una definición de búsqueda, salvo que ya haya alimentado una longlist cerrada (409 HAS_HISTORY). Contesta 204. |
/copilot/threads/{threadId} | Borra una conversación propia con el asistente. |
Configuración de la cuenta
DELETE | Qué hace |
|---|---|
/account/me/avatar | Quita tu foto de perfil. |
/account/members/{memberId} | Cancela una invitación pendiente. Un miembro que ya aceptó no se borra: se desactiva. |
Algunos de estos tienen además sus propias reglas de rol: las rutas de facturación y de miembros son solo para OWNER, y las que mueven el plan o la cuenta exigen al OWNER en persona en la app. Ver la referencia REST.
Las acciones que borran
Entre todas las acciones, solo dos borran: delete_bookmark (una lista) y delete_draft_job_post (un borrador de vacante en el que nadie trabajó, con la misma regla que el DELETE de arriba). Ninguna otra acción borra datos.