Upload media

Posts refer to media by id. Add a file to your library first, then pass the returned media.id as mediaId in POST /posts.

Import from a URL (up to 25 MB)

curl -s -X POST "$CH_API/media" \
  -H "Authorization: Bearer $CH_KEY" -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/launch.png" }'

The URL must be public https. CreatorHyve downloads it, checks that the bytes really are the declared type (JPEG, PNG, WebP, GIF, MP4, MOV or WebM), stores it, and answers:

{ "media": { "id": "9d3c...", "url": "https://storage.creatorhyve.com/uploads/...", "type": "image" } }

Upload a large file

1. POST /media with { "action": "init", "type": "video/mp4", "size": 52428800 } returns an upload_url and a key.
2. PUT the file to upload_url with the same Content-Type header.
3. POST /media with { "action": "complete", "key": "<key>", "filename": "launch.mp4" } verifies the file and returns the media object.

Images may be up to 50 MB and videos up to 500 MB, within your plan's storage. Repeating complete for the same key returns the same item.