ClaixClaixEnglish

Ventana de Contexto

Ventana de Contexto

Pregunta a un documento persistido tras una extracción con window_context activo.

Ventana de Contexto · Eliminar espacio

Eliminar un espacio de conocimiento

Endpoint

DELETEhttps://claix.dev/delete-space/{space_id}

Borra un espacio de conocimiento por space_id. No recibe body ni query params: el identificador viaja únicamente en la URL.

El borrado solo afecta a un espacio de la misma cuenta que la API key. Si el UUID no existe o pertenece a otra cuenta, responde 404 con el mismo mensaje genérico, sin revelar el motivo exacto.

URL pública: DELETE https://claix.dev/delete-space/{space_id}

La operación es irreversible. Esta llamada es gratuita: no se factura ni consume el cupo de extracciones ni de ventana de contexto.

1. Autenticación

Toda petición debe incluir tu API key. Es una credencial de servidor personal, distinta de cualquier token de sesión de usuario.

Opción A — Header dedicado (recomendado):

x-api-key: <TU_API_KEY>

Opción B — Header estándar Authorization:

Authorization: Bearer <TU_API_KEY>

Con uno de los dos es suficiente. Si envías ambos, x-api-key tiene prioridad.

El sistema valida que la key exista y esté activa, y que la cuenta no esté suspendida. Si falla, responde 401.

2. Formato de la petición

Método: DELETE · Body: no requerido · Query params: ninguno

ParámetroUbicaciónObligatorioDescripción
space_idURL pathSíUUID del espacio que devolvió POST /create-space.

Formato esperado de la URL: /delete-space/{space_id}

3. Cómo construir la llamada

  1. Obtén el space_id de la creación original o de tu almacén interno.
  2. Sustituye {space_id} en la URL por ese UUID.
  3. Envía DELETE con tu API key en x-api-key (sin body).

4. Ejemplos de llamada

Usa el panel de código de la derecha para copiar ejemplos en cURL, JavaScript, Python, etc.

5. Formato de la respuesta exitosa

HTTP 200 — El espacio se borró. La respuesta solo incluye el space_id eliminado; no hay campo success. Si el borrado no fue posible, la petición termina en 404 antes de construir una respuesta de éxito.

{
  "space_id": "5b9e2c14-7d3a-4f8b-9e1c-6a0d4b8f2e7c"
}

6. Códigos de error

{
  "error": "Descripción legible del problema.",
  "detalle": "Información técnica adicional (solo presente en algunos casos)."
}

400 — Falta space_id en la URL o no tiene formato UUID válido.

401 — Autenticación fallida: key ausente, inexistente, desactivada o cuenta no activa.

404 — El espacio no existe, pertenece a otra cuenta o ya fue eliminado. Mismo mensaje genérico por seguridad.

Ejemplo de 404:

{
  "error": "No existe ningún espacio de conocimiento con id '5b9e2c14-7d3a-4f8b-9e1c-6a0d4b8f2e7c'."
}

405 — Método distinto de DELETE. · 500 — Error interno.

7. Resumen de códigos

CódigoCategoría¿Reintentar?
200Éxito — espacio borrado—
400Error del cliente (space_id ausente o mal formado)No, corrige la petición primero
401Error de autenticaciónNo, corrige las credenciales primero
404Espacio no encontrado, ajeno o ya eliminadoNo, corrige el space_id primero
405Método HTTP incorrectoNo, usa DELETE
500Error interno del servidorSí, con precaución

8. Buenas prácticas

  • Usa siempre el dominio público claix.dev, no la URL directa de Supabase.
  • Borra el espacio cuando el expediente o el cliente ya no necesite consultas cruzadas. Los documentos que estaban agrupados siguen existiendo de forma individual: este endpoint no los elimina.
  • Tras el borrado, POST /space-context/{space_id} devolverá 404.
  • No incluyas tu API key en frontend ni repositorios públicos.

Ejemplos de petición

curl -X DELETE "https://claix.dev/delete-space/5b9e2c14-7d3a-4f8b-9e1c-6a0d4b8f2e7c" \
  -H "x-api-key: <TU_API_KEY>"