v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB

Multi FileFeed Imports

Upload a file from S3 to a Multi FileFeed import

Uploads a file from a customer's S3 bucket into a Multi FileFeed import. The server assumes an IAM role to read the specified S3 object, verifies it exists and is within the file size limit, downloads it, and stores it as an uploaded file on the import.

The object_uri must be a valid S3 URI in the format s3://bucket/key. The s3_account_id identifies which S3 account credentials (role ARN and external ID) to use for the STS AssumeRole call. The referenced bucket and object must be accessible to the IAM role configured on that S3 account.

Both the object URI and the file basename (derived from the S3 key) must be unique within the import. If either already exists, a 409 Conflict is returned.

post/v0/multi-file-feeds/{multi_file_feed_id}/imports/{multi_file_feed_import_id}/upload-from-s3

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

s3_account_idinteger required

The ID of the S3 account to use for accessing the S3 object. The S3 account stores the IAM role ARN and external ID used for the STS AssumeRole call.

object_uristring required

The S3 URI of the file to upload (e.g. s3://bucket/path/to/file.csv). The bucket and object must be accessible to the IAM role configured on the specified S3 account.

Response

Successful response. The file has been downloaded from S3 and stored on the import. The primary way to verify the request's success or failure is the response status code. In a future API version this endpoint may return additional metadata about the uploaded file.

object required