Saltar al contenido
API v1 · https://bentho.org/api
GET/api/rag/{espacio}/documents

Los documentos del espacio

La lista de documentos que Bentho puede usar para responder, del más reciente al más antiguo.

  • PERMISOlee (vale cualquier clave)
  • CRÉDITOSno gasta
  • AUTENTICACIÓNBearer bth_…

Para descargar uno: GET /api/rag/{espacio}/documents/{archivo}. Llega con application/pdf para los PDF y text/plain para el resto, sin Content-Disposition: ponle tú el nombre al guardarlo.

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies).

RESPUESTA 200

CAMPOTIPOQUÉ ES
documentsarrayOrdenados por fecha de modificación, el más reciente primero.
documents[].filenamestringEl nombre del archivo.
documents[].sizeintegerTamaño en bytes.
documents[].modifiednumberFecha de modificación, en segundos desde 1970 (con decimales).

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
404El espacio no existe—

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

  • Solo lista las extensiones admitidas: .pdf, .docx, .txt y .md. Un espacio sin documentos devuelve {"documents": []}.