Reclee

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

DELETEContesta 405 y sugiereQué hace la acción
/crm/leads/{leadId}archive_leadArchiva la empresa junto con sus requests abiertos (o la restaura).
/crm/contacts/{contactId}archive_contactArchiva el contacto.
/crm/requests/{requestId}archive_requestArchiva el request.
/crm/activity/{activityId}update_lead_activityCorrige la entrada de actividad.
/crm/contact-history/{entryId}add_contact_historyCorrige (o agrega) una entrada del historial laboral del contacto.
/talent/poolremove_from_poolSaca personas del talent pool (las archiva para el workspace).
/talent/pool/{profileId}remove_from_poolIgual, para una persona.
/talent/pool/{profileId}/contacts/{contactId}update_profile_contactCorrige un contacto cargado a mano.
/talent/notes/{noteId}update_noteCorrige la nota de un perfil.
/talent/tags/{tagId}update_tagRenombra o archiva el tag.
/job-posts/{jobPostId}/notes/{noteId}update_noteCorrige la nota de una vacante.
/sourcing/talent-icps/{talentIcpId}close_talent_icpCierra el perfil ideal.
/ats/comments/{commentId}update_application_commentCorrige el comentario.
/ats/interviews/{interviewId}update_interviewEdita o cancela la entrevista.
/ats/labels/{labelId}update_labelRenombra o archiva la etiqueta.
/ats/questions/{questionId}update_interview_questionEdita o descarta la pregunta.
/ats/applications/{applicationId}/screening/{answerId}review_screening_answerRevisa 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

DELETEQué hace
/notifications/{notificationId}/readMarca 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}/answerQuita la respuesta de una pregunta de entrevista; la pregunta queda sin responder.
/account/workspace/deletionCancela el borrado programado del workspace. Solo el OWNER en persona en la app: con una API key contesta 403.
/billing/planCancela un cambio de plan que todavía no ocurrió. Solo el OWNER en persona: con una API key contesta 403.
/billing/cancellationRetira 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

DELETEQué 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/tagsLe quita un tag a varios perfiles a la vez. Cuerpo: { "profileIds": [...], "name": "..." } (hasta 500 ids); contesta cuántos se quitaron.
/talent/bookmarks/{bookmarkId}/profilesSaca 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

DELETEQué 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

DELETEQué hace
/account/me/avatarQuita 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.

En esta página