File Upload

Overview

Woflow's Files API is tailored for clients without self-hosted catalog sources. It facilitates easy file uploads, ensuring your data can be seamlessly integrated into Woflow's system.

Supported File Formats

We support a variety of file formats. Each file has a maximum limit of 50MB, and you can upload up to 9 files per request:

File Format	MIME Type
JPEG	image/jpeg
PDF	application/pdf
PNG	image/png
CSV	text/csv
XLSX	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
WEBP	image/webp

Note: PDF files generate a unique uuid for each page. Use these uuids in the catalog_sources array for the Create Job API.

Example Request

curl --location 'https://gateway.woflow.com/v1/files' \
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Token api_key=<api_key>' \
--form 'file0=@"/Users/username/menu-samples/Panera-Bread.PDF"' \
--form 'file1=@"/Users/username/menu-samples/panera-bread-beverage-page.jpg"'

Example Response

{
  "catalog_sources": [
    "146483f9-5bc2-4251-b97b-faf58229ac3c",
    "a8a44f67-580e-4d69-a40e-5b859f71d7b2",
    "423bf398-f21a-4fa5-9424-3411cf6a2409",
    "4eb1ab01-375d-44c2-8596-c55f9f8a9b18"
  ]
}

Remember to always check file sizes and formats before uploading to ensure compatibility and successful processing.