API Reference

Media

Upload images and videos before referencing them in posts. Uploading is a two-step flow: request a signed upload URL, upload the file to it, then confirm.

Request an upload URL

POST/api/upload

Returns a signed URL to upload a media file to. Only image and video content types are accepted.

Request body

filenamestringrequired

Minimum string length:1

contentTypestringrequired

Minimum string length:1

Confirm an upload

POST/api/upload/confirm

Confirms that a file was uploaded to the signed URL and registers it as an asset. Returns the asset id to use in post payloads.

Request body

file_pathstringrequired

Minimum string length:1