Skip to main content
Every time you ask a question, BoardPulse AI automatically generates two export files from the full query result — a CSV and an XLSX — regardless of whether you asked for them. These files are created in the background as part of the response pipeline and are immediately available for download via direct links included in every ChatResponse.

​
Export artifact schema

Each export is represented as an ExportArtifact object in the exports array of the response:

​
File naming convention

Export file names are generated from the AI’s suggested export_base_name (a slug derived from your question) combined with a Unix timestamp:
For example, a question about regional sales might produce:
The base name is slugified automatically — spaces and special characters become hyphens, and the result is lowercased. If no base name is available, the system falls back to boardpulse-export.

​
Downloading exports

Use a GET request to retrieve any export file by name:
The server validates the file path before serving it. Attempts to traverse outside the exports directory (e.g., via ../ in the filename) will fail with a 404.

​
Example exports array in a response

​
Configuration

The directory where export files are stored is controlled by the EXPORTS_DIR environment variable:
The directory is created automatically if it does not exist. In the default Docker Compose setup, this path is bind-mounted so files persist across container restarts.
When using Open WebUI, the chat interface displays a maximum of 20 rows in the results table to keep the conversation readable. The export files always contain the full result set from the query. Download the CSV or XLSX to access all rows.
Export file names are timestamped and never overwritten. You can download the same question’s results multiple times safely — each query run produces a new, uniquely named file.