Request a file upload

Request a signed URL to upload a file.

Create a file upload record and obtain a signed URL for direct PUT upload to S3. Different purposes accept different file types (e.g. CSV, XLSX).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
purposeenumRequired
  • BULK_PROJECT_UPSERT - Bulk Project Upsert
Allowed values:
filenamestringRequired<=255 characters
mime_typestringRequired<=100 characters

Response

dataobject
The API file upload object. This object represents a file that has been uploaded via the Public API. Files can be used for various purposes such as bulk data imports.