v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB
Templates

Upload a custom sample file

Upload a file to serve as the downloadable sample file shown to end users in the importer's upload pane. When set, this file replaces the sample file that OneSchema otherwise auto-generates from the template's columns. Subject to a 5 MiB file size limit. Accepted extensions: .xlsx, .xls, .xlsm, .xlsb, .csv. Requires multipart/form-data with a single file field.

post/v1/templates/{key}/sample-file

Path parameters

keystring required

The key of the template to attach the sample file to.

Response

Successful response

template_keystring

The key of the template the file was attached to.

sample_file_namestring

The original filename of the uploaded file.