REST APIPOST

Media Upload

Upload images and videos to AdaptlyPost using presigned URLs, then attach the returned media IDs to any scheduled post.

Media upload is a two-step process: first request a presigned upload URL, then upload your file directly to that URL. This keeps your files secure and allows for large uploads.

POSThttps://post.adaptlypost.com/post/api/v1/upload-urls

Request presigned upload URLs for one or more files. You can request up to 20 URLs in a single call.

API Key (Bearer token)

Permission:media.uploadRoles and permissions

Body Parameters

Parameter	Type	Description
`files`REQUIRED	`FileUploadRequest[]`	Array of file metadata (1-20 items)
`files[].fileName`REQUIRED	`string`	Original file name
`files[].mimeType`REQUIRED	`string`	image/jpeg, image/png, image/webp, video/mp4, video/quicktime, or a document type for LinkedIn DOCUMENT posts (PDF, PPT, PPTX, DOC, DOCX; see Supported Formats). Keep the file extension in fileName

Step 1: Get Upload URLs

Send a POST request with file metadata to receive presigned upload URLs. See the code panel for an example request and response.

Step 2: Upload the File

Use the uploadUrl from the response to upload your file via a PUT request. See the code panel for an example.

Step 3: Use in a Post

Pass the publicUrl from the upload response as a mediaUrls entry when creating a post. You can reuse one publicUrl across as many posts as you like; the file is kept until the last post referencing it has published. Reuse the publicUrl you uploaded, not a mediaUrls value read back from a published post, since those may be expiring platform links.

Upload URL Expiration

Presigned URLs expire after 1 hour. Upload your file before the expiresAt timestamp or request a new URL.

Supported Formats

Type	MIME Types
Images	`image/jpeg`, `image/png`, `image/webp`
Videos	`video/mp4`, `video/quicktime`
Documents (LinkedIn)	`application/pdf`, `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation`, `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document`

Get upload URLs

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/upload-urls \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "files": [
      {
        "fileName": "product-photo.jpg",
        "mimeType": "image/jpeg"
      }
    ]
  }'

Upload file

curl --request PUT \
  --url "https://storage.adaptlypost.com/presigned/abc123..." \
  --header 'Content-Type: image/jpeg' \
  --data-binary @product-photo.jpg

201

{
  "urls": [
    {
      "fileName": "product-photo.jpg",
      "uploadUrl": "https://storage.adaptlypost.com/presigned/abc123...",
      "publicUrl": "https://cdn.adaptlypost.com/uploads/product-photo.jpg",
      "key": "uploads/usr_001/product-photo.jpg",
      "expiresAt": "2026-03-14T13:00:00Z"
    }
  ]
}