POST
/api/rag/{espacio}/load_documentsSube documentos
Sube uno o varios archivos. Se guardan al momento y se indexan en segundo plano: consulta indexing_status para saber cuándo puedes preguntarles.
- PERMISOescribe
- CRÉDITOSgasta créditos
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). |
CUERPO · MULTIPART/FORM-DATA
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| files | archivo, repetible | SÍ | Uno por archivo. Admitidos: .pdf, .docx, .txt y .md. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| status | string | Siempre "processing". |
| files | string[] | Los nombres guardados. |
| message | string | «<N> archivo(s) guardado(s). Indexación en segundo plano.» |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 400 | Extensión no admitida | Extensión no soportada: <nombre>. Permitidas: ['.docx', '.md', '.pdf', '.txt'] |
| 400 | Sin archivos | No se recibieron archivos. |
| 402 | Créditos agotados (indexar gasta créditos) | — |
| 403 | Clave de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 413 | Más de 200 MB en total | La subida excede el tamaño máximo total permitido. |
| 413 | Más de 20 archivos | Demasiados archivos (máximo 20 por subida). |
| 413 | Un archivo de más de 50 MB | El archivo '<nombre>' excede el máximo de 50 MB. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Subir un archivo con el mismo nombre lo reemplaza.
- Si un archivo de la tanda tiene una extensión no admitida, los anteriores quedan guardados pero no se indexan: sube primero solo archivos válidos.