Ventana de Contexto · Quitar del espacio
Desacoplar un documento de su espacio
Endpoint
https://claix.dev/remove-document-from-space/{document_id}Pone espacio_id a null en el documento. El documento sigue existiendo; solo deja de pertenecer al espacio. Si ya no tenía espacio, responde 400.
También acepta POST con la misma URL. Tras el desacoplado puedes volver a asignarlo con POST /add-space.
URL pública: DELETE https://claix.dev/remove-document-from-space/{document_id}
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. Si falla, responde 401.
2. Formato de la petición
Método: DELETE (también POST) · Body: no requerido · Query params: ninguno
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
| document_id | URL path | Sí | UUID del documento que tiene un space_id asignado. |
Formato esperado de la URL: /remove-document-from-space/{document_id}
3. Cómo construir la llamada
- Obtén el
document_iddel documento que quieres desacoplar. - Sustituye
{document_id}en la URL por ese UUID. - Envía
DELETE(oPOST) con tu API key enx-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 documento queda sin espacio asignado.
{
"success": true,
"document_id": "d4a1e9d2-8b1c-4f3e-9a02-8b1e9f3c7a4b",
"previous_space_id": "5b9e2c14-7d3a-4f8b-9e1c-6a0d4b8f2e7c",
"espacio_id": null,
"file_name": "factura.pdf",
"version": 1,
"message": "Documento desacoplado del espacio. Ahora está sin space_id."
}| Campo | Tipo | Descripción |
|---|---|---|
| success | boolean | Siempre true en una respuesta 200. |
| document_id | string (uuid) | Documento desacoplado. |
| previous_space_id | string (uuid) | Espacio del que se ha quitado. |
| espacio_id | null | Siempre null tras la operación. |
| file_name | string | Nombre de archivo del documento. |
| version | number | Versión actual del documento. |
| message | string | Mensaje legible de confirmación. |
6. Códigos 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"
}400 — document_id ausente o inválido, o el documento ya no tiene espacio asignado.
401 — Autenticación fallida: key ausente, inexistente, desactivada o cuenta no activa.
404 — El documento no existe o no pertenece a tu cuenta.
405 — Método no permitido. · 500 — Error interno.
7. Resumen de códigos
| Código | Categoría | ¿Reintentar? |
|---|---|---|
| 200 | Éxito — documento desacoplado | — |
| 400 | Error del cliente (sin espacio o document_id inválido) | No, corrige la petición primero |
| 401 | Error de autenticación | No, corrige las credenciales primero |
| 404 | Documento no encontrado | No, corrige el document_id primero |
| 405 | Método HTTP incorrecto | No, usa DELETE o POST |
| 500 | Error interno del servidor | Sí, con precaución |
8. Buenas prácticas
- Esto no borra el documento: solo lo saca del espacio. Para borrarlo usa
DELETE /delete-document/{document_id}. - Tras desacoplar, el documento ya no aparece en consultas de
/space-contextde ese espacio. - Usa siempre el dominio público
claix.dev, no la URL directa de Supabase. - No incluyas tu API key en frontend ni repositorios públicos.