Upload media
Uploads one file as multipart/form-data and appends it to the post’s media. Accepted files: JPEG, PNG, GIF and WebP images (HEIC and HEIF too when the server can convert them, stored as JPEG), MP4 and MOV videos, and PDF documents. Size caps: 10 MB per image (and at most about 67 megapixels, 8192 × 8192 pixels in total), 1 GB per video, 100 MB per PDF. Each network enforces its own, usually smaller, caps when the post is scheduled or published (GET /content-types). A type the post’s channel does not accept fails with 422: This file type is not supported by the post's channel. Posts that are publishing, published, partially published or failed cannot take media: 422 on post with This post has already been processed and cannot be re-published. Duplicate it to try again. On Pinterest and TikTok the content type is chosen again from the post’s media, as on create.
Authorizations
Workspace API key from Settings → API Keys.
Path Parameters
Post id. A post of another workspace returns 404.
Body
The file.
Response
The post with the new media.
A post on one channel. Posts created together from several channels are independent posts that share a post_group_id.
Shared by the posts created in one batch.
A workspace member. Only the id and name are exposed.
Post text, stored as sent (posts written in the app hold the editor's HTML).
pending_approval is a post a member who needs approval asked to schedule or publish.
draft, pending_approval, scheduled, publishing, published, partially_published, failed queue: the post holds a slot of the channel's posting schedule. custom: it is scheduled at its own time.
queue, custom, null UTC, format Y-m-d H:i:s.
UTC, format Y-m-d H:i:s.
Who asked for approval (not always the author).
UTC, format Y-m-d H:i:s.
A workspace member. Only the id and name are exposed.
UTC, format Y-m-d H:i:s.
Repeat rule, or null.
network for posts imported from the network (published outside TryPost).
trypost, network UTC, format Y-m-d H:i:s.
UTC, format Y-m-d H:i:s.

