Media

Create an upload URL, upload the file, and request completion verification before attaching media to a post. Use a media ID only after the server marks it ready.

curl -X POST 'https://<service-domain>/api/v1/media/presign' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"fileName":"photo.jpg","contentType":"image/jpeg","bytes":100000}'

Use POST /api/v1/media/from-url to import an image from a public HTTPS URL. The server checks the URL and file. Video and per-platform media behavior remain subject to official verification and live-account testing.