Skip to main content
POST
Presigned URL
← Custom KPI Generate a presigned S3 PUT URL for uploading an evidence file. Use this before calling Submit Response — upload the file to the returned URL, then include the file_id in your submission’s attachment_file_ids.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
UUID of the parent dataset

Query Parameters

string
Send sha256 to receive upload_headers: the exact headers your PUT to upload_url must carry. When you also send content_hash, they may include x-amz-checksum-sha256, so storage refuses any bytes other than the ones you hashed (400 BadDigest). Any other value is ignored.

Body Parameters

string
required
Original file name (1–255 characters)
string
MIME type of the file (e.g. application/pdf, image/png). Max 255 characters.
integer
required
File size in bytes. Must be between 1 and 10 485 760 (10 MB).
string
SHA-256 of the file’s bytes, as 64 lowercase hex characters. Optional.

Response

Returns the presigned upload URL and file metadata (HTTP 201).
string
Presigned S3 PUT URL — upload your file here with a PUT request
string
File UUID — include this in attachment_file_ids when submitting
string
Echoed file name
object | null
Only with upload_checksum=sha256: the headers to send, unchanged, with the PUT to upload_url (they are part of its signature). null otherwise.

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

422 Validation Error

Cause: File exceeds 10 MB limit

Submit Response

Submit values with the uploaded attachments

Edit Values

Update values for a campaign-assignment