Upload a content file

post

https://upload.telemetrytv.com/content_uploads

Accepts a multipart file upload, detects its type, optionally converts/resizes it, stores it in S3, and creates (or replaces) a content record. Processing runs asynchronously by default; pass ?wait=true to block until done.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

wait

boolean

Defaults to false

Block until processing completes and return the created content object(s).

Body Params

file

required

The file to upload. Max 1 GB overall; images additionally capped at 20 MB and 16 000 x 16 000 px (auto-resized to 4 096 x 4 096 if exceeded). Type is detected from magic bytes, falling back to file extension. Supported types: png, jpg, gif, svg, mp4, webm, ogg, mov, avi, pdf, ppt, pptx, doc, docx, xls, xlsx, vtt, srt, zip. No Content-Type header validation is performed.

filename

string

Override the uploaded file's name. Falls back to the multipart filename.

folder_id

string

MongoDB ObjectID of the destination media folder.

upload_state

string

enum

Defaults to upload

upload creates a new content record; replace updates an existing one.

Allowed:

content_id

string

Required when upload_state=replace. MongoDB ObjectID of the content to replace.

filesync_id

string

ID of the associated filesync entry.

replaced_file_name

string

Original filename of the content being replaced.

replaced_file_s3_path

string

S3 path of the file being replaced.

google_drive_id

string

Google Drive file ID, when the source originates from Google Drive.

google_email

string

Google account email associated with the Drive source.

canva

boolean

Set to true when the file originates from a Canva export.

canva_design_id

string

Canva design ID.

canva_export_url

string

Canva export URL.

owner_page_id

string

Page ID that owns this content (e.g. for webshot content).

hidden

boolean

Defaults to false

If true, the created content record is hidden from the media library (e.g. subtitles).

prompt_id

string

AI prompt ID that triggered this upload.

webshot

object

Webshot metadata. Only relevant when content originates from a web screenshot.

Headers

Authorization

string

required

Token <token> or Bearer <token>. Alternatively pass ?token= as a query param.

REQUEST-ID

string

Optional idempotency / tracing identifier.

Responses

401

Missing or invalid authentication token.

403

Authenticated user lacks the required media upload permission.

415

Unsupported file type detected from magic bytes / extension.

201Upload accepted (or completed when wait=true). When wait=false returns a Process object. When wait=true returns an array of content objects.

400Bad request — malformed form data, or image exceeds the 20 MB size limit.

402Video uploads require a plan upgrade.

500Internal server error during upload processing.