Skip to main content

Upload a file

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 with addReportDatasheets. Leading and trailing spaces are removed, and a name containing a / keeps only its last part: exports/Q3 pipeline is stored as Q3 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. With replaceDataset, 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 becomes Column N, after the column's position, and a repeated one gets a _2, _3 suffix. 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. With createDataset, it becomes a new uploaded file named after the file, such as Q3 pipeline.xlsx; with replaceDataset, it replaces the content of an uploaded workbook, which keeps its id and name. An uploaded workbook can't be added to a report with addReportDatasheets, 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 as id to replaceDataset and deleteDataset and, for a CSV file, as datasetId to addReportDatasheets to add it to a report.
  • name (string, required): The uploaded file's name: the name it was created with for a CSV file, or the workbook's file name for an Excel workbook, such as Q3 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 with replaceDataset, or when it was uploaded if it has never been replaced.