Sign in

v1

latestOpenAPI 3.1.02026-07-26436887.6 KB
main
s3

Generate a presigned URL for direct CSV upload

Generate a presigned PUT URL for direct CSV file upload to S3/MinIO.

This endpoint enables browser-to-storage uploads without passing through the backend

Access Control:

  • All authenticated users can upload CSV files scoped to their organization.
  • Files are stored with organization-scoped keys for multi-tenancy.

Returns:

  • upload_url: Presigned URL (valid for 15 minutes) for PUT request
  • file_key: Unique storage key to use as source_id in campaign creation
  • expires_in: URL expiration time in seconds
post/api/v1/s3/presigned-upload-url

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

file_namestring required

CSV filename

file_sizeinteger required

File size in bytes (max 10MB)

content_typestring

File content type

Response

Successful Response

upload_urlstring required
file_keystring required
expires_ininteger required