Sign in

v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB
Multi FileFeed Imports

Create a direct file upload for a Multi FileFeed import

Creates a direct upload for a Multi FileFeed import. Returns an upload_id, a presigned_url, and a content_type. The client must PUT the file directly to the presigned_url, setting the returned content_type as the Content-Type header on the PUT request (the file store will reject the upload otherwise).

The direct upload flow consists of three steps:

  1. Create (this endpoint): creates a tracking record and returns the presigned URL, content type, and upload ID.
  2. Upload: the client uploads the file directly to cloud storage using the presigned URL.
  3. Submit (direct-uploads/{upload_id}/submit): verifies the upload succeeded and links the file to the import.
post/v0/multi-file-feeds/{multi_file_feed_id}/imports/{multi_file_feed_import_id}/direct-uploads

Path parameters

multi_file_feed_idinteger required

ID of the Multi FileFeed

multi_file_feed_import_idinteger required

ID of the Multi FileFeed import

Request body

filenamestring required

The name of the file to upload (e.g. "data.csv"). Must be unique within this import.

Response

Successful response

upload_idinteger required

Unique identifier for this upload. Pass this to the direct-uploads/{upload_id}/submit endpoint after uploading.

presigned_urlstring uri required

Presigned PUT URL for uploading the file directly to the file store. Expires in 1 hour.

content_typestring required

The Content-Type that MUST be set as the Content-Type header on the PUT request to the presigned URL.