Files

Register a file and obtain a signed upload URL

Step 1 of submission. Returns a signed_url — PUT your file bytes there, then pass file_id to POST /v1/bundles.

post/v1/files

Request

  • Base URL: https://api.blee.com
  • URL: https://api.blee.com/v1/files
  • Auth: HTTP bearer

Request body

filenamestring required

Name of the file to upload, including extension (e.g. 'ad_creative.pdf')

purpose'primary' | 'supporting_doc'

"primary" (default) — main creative asset (uploads bucket). "supporting_doc" — evidence attachment such as a script or brief (media_source_evidence/temporary/ bucket). Pass the returned file_id in supporting_doc_file_ids on POST /v1/bundles.

Example request

{
  "filename": "ad_creative.pdf",
  "purpose": "primary"
}

Response

File registered. PUT bytes to signed_url.

file_idstring required

Unique ID for this file registration. Pass to submit_bundle.

signed_urlstring required

Pre-signed URL. PUT your file bytes here (Content-Type header required).

expires_atstring required

ISO-8601 datetime when the signed URL expires.

Changes

No recorded changes to this operation across all 1 revision of this API.