Documentation menu
Posts

Prepare media uploads

Create short-lived direct S3 PUTs for post media.

POSThttps://app.tryadeli.com/api/v1/media/uploads
AuthorizationBearer <API key>How keys work

Create short-lived S3 PUT descriptors before publishing any local file. This is Adeli's recommended media transport for Instagram, Facebook, TikTok, YouTube, X, Bluesky, and LinkedIn. File bytes go directly to private S3 rather than through a Vercel Function.

clientId is your correlation value and must be unique inside the request. Use post_media for normal media and youtube_thumbnail only for a YouTube JPEG or PNG thumbnail. Counts, MIME types, and sizes are checked against the selected platform before any capability is issued. For linkedin, a request declares up to 20 files: JPEG, PNG, or GIF images up to 20 MB each, an MP4 video up to 500 MB, or a PDF up to 100 MB.

To post the same file to several platforms, send platforms (for example ["instagram", "tiktok", "youtube"]) instead of platform. Each file is checked against every listed platform's limits, so it must fit the strictest of them, and its uploadId starts with shared/staging/. Use it in a publication, or in a single-platform post to any of the listed platforms. Give platform or platforms, not both.

The 201 response has one entry per declaration:

PUT the raw bytes to url with every returned header unchanged. Do not send your Adeli API key to S3 and do not add or alter metadata. URLs expire after ten minutes and grant access to one random object only. Uploads may run concurrently; use clientId to restore the original order.

Then publish a small JSON request with staged references:

json
{
  "platform": "youtube",
  "profileId": "00000000-0000-4000-8000-000000000001",
  "accountId": "00000000-0000-4000-8000-000000000002",
  "title": "Launch",
  "privacy_status": "unlisted",
  "made_for_kids": false,
  "video": { "upload_id": "youtube/staging/opaque.mp4" },
  "thumbnail": { "upload_id": "youtube/staging/opaque.jpg" }
}

Before contacting a provider, Adeli verifies the object's organization, profile, platform, purpose, MIME declaration, and exact S3 byte length. Missing, expired, or mismatched media returns 422 invalid_media. Retry initiation if a URL expires. Retrying a single PUT restarts that file; resumable S3 multipart upload is not part of this version.

API keys belong on your server. Do not expose one in browser code or request broad customer-origin bucket CORS.