Upload a file
- OpenAPI 3.1.0 document: https://api.rollstack.com/public/v1/openapi.json
- The whole reference in Markdown: https://docs.rollstack.com/llms-full.txt
- An index of the reference: https://docs.rollstack.com/llms.txt
POST https://api.rollstack.com/public/v1/datasets
Stores a CSV for the slides agent to build slides from: a header row, then at least one data row, at most 10 MB. Add it to a report with addReportDatasheets. Over MCP the CSV is written into the tool call, so send large files to this REST endpoint instead. Or send an Excel workbook (.xlsx, at most 10 MB) as multipart/form-data in the file field: it is stored as it is, with all its sheets, formatting and charts, and the user picks its sheets and ranges for a report in the app's editor. Legacy .xls, macro-enabled and password-protected workbooks are rejected. A workbook is read as saved: formulas show their saved results, and nothing is recalculated. When you have the file and a shell, send the file itself with createDatasetUpload instead of writing it into the tool call. List the sheets of a workbook with getDataset, then add a sheet or a range of one to a report with addReportDatasheets.
Requires the slide_decks:write scope.
Operation ID: createDataset.
Headers
Idempotency-Key(string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.
Request body, required
application/json
name(string, required): A name for the uploaded file, which its datasheet takes when you add the file to a report withaddReportDatasheets. Leading and trailing spaces are removed, and a name containing a/keeps only its last part:exports/Q3 pipelineis stored asQ3 pipeline. From 1 to 255 characters. Example:Q3 pipeline.csv(string, required): The file's data, as CSV text: a header row naming the columns, then at least one row of data. WithreplaceDataset, it replaces the file's whole content, header included, and the uploaded file must be a CSV file. The header's names become the column names of the datasheets made from the file: a blank one becomesColumn N, after the column's position, and a repeated one gets a_2,_3suffix. Values can be separated by commas, semicolons or tabs, detected from the header row. At most 10 MB. Example:region,revenue EMEA,1200000 Americas,2400000.
multipart/form-data
file(string (binary), required): The Excel workbook to upload. WithcreateDataset, it becomes a new uploaded file named after the file, such asQ3 pipeline.xlsx; withreplaceDataset, it replaces the content of an uploaded workbook, which keeps its id and name. An uploaded workbook can't be added to a report withaddReportDatasheets, which takes uploaded CSV files only. The file's name must end in.xlsx, and it can be at most 10 MB; legacy.xls, macro-enabled and password-protected workbooks are rejected.
Response 201
Success
application/json
id(string, required): Unique identifier for the uploaded file. Pass it asidtoreplaceDatasetanddeleteDatasetand, for a CSV file, asdatasetIdtoaddReportDatasheetsto add it to a report.name(string, required): The uploaded file's name: thenameit was created with for a CSV file, or the workbook's file name for an Excel workbook, such asQ3 pipeline.xlsx. Replacing the file's content doesn't change it.createdAt(string (date-time), required): When the file was uploaded. Replacing its content doesn't change it.updatedAt(string (date-time), required): When the file's content was last replaced withreplaceDataset, or when it was uploaded if it has never been replaced.