ClaixClaixEN

Claix Retrieve

Routes Actions

Crea, edita y elimina rutas de Retrieve por API. Las tablas y columnas deben coincidir con tu Data Map publicado.

Rutas · Eliminar

Eliminar una ruta por API

Endpoint

POSThttps://claix.dev/routes/delete/{route_id}

Borra una ruta de tu cuenta y todas sus versiones. La operación es irreversible. Solo elimina rutas que te pertenecen: si el UUID no existe o es de otra cuenta, responde 404.

Sustituye {route_id} por el UUID. También se admite DELETE, o enviar route_id en el JSON / en la query.

Esta llamada es gratuita: no se factura.

1. Autenticación

Incluye tu API key en cada petición:

x-api-key: <TU_API_KEY>

o

Authorization: Bearer <TU_API_KEY>

2. Formato de la petición

Método: POST (también DELETE)

CampoTipoObligatorioDescripción
route_iduuidSíEn la URL /routes/delete/{route_id}. Alternativas: body JSON { "route_id": "..." } o ?route_id=.

Si usas la URL con route_id, no hace falta cuerpo.

3. Cómo construir la llamada

  1. Obtén el route_id de la ruta que quieres borrar.
  2. Llama a https://claix.dev/routes/delete/<route_id> con POST o DELETE y tu API key.
  3. Comprueba 200: solo entonces la ruta y sus versiones se han eliminado.

Si la ruta estaba asignada a un agente, revísala en el dashboard: deberás quitar esa referencia antes de volver a usarla.

4. Ejemplos de llamada

Consulta el panel de la derecha para ver ejemplos en cURL, JavaScript, Node.js, Python, PHP y n8n.

5. Formato de la respuesta exitosa

200 OK · Content-Type: application/json

{
  "success": true,
  "deleted": true,
  "route_id": "7c2f9a1e-4b8d-4e6a-9f21-0a1b2c3d4e5f",
  "name": "Agenda de citas",
  "slug": "agenda_de_citas"
}

6. Errores frecuentes

HTTPCuándo
401API key ausente, inválida o cuenta inactiva.
404La ruta no existe o no pertenece a tu cuenta.
400Falta route_id o no es un UUID válido.
405Método no permitido.
500Error interno al borrar.

Ejemplo de error:

{
  "error": "Descripción legible del problema.",
  "detalle": "Información técnica adicional (solo presente en algunos casos).",
  "log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}

Ejemplos de petición

curl -X POST "https://claix.dev/routes/delete/7c2f9a1e-4b8d-4e6a-9f21-0a1b2c3d4e5f" \
  -H "x-api-key: <TU_API_KEY>"