POST`/file/get-signed-upload-urls`

Generates pre-signed URLs for uploading media files (images, videos, PDFs, or YouTube caption files) directly to S3.

https://api.postfa.st/Auth: pf-api-keyRate limit: 1,260 requests per day, 180 per minuteMaximum 250 MB per video, 10 MB per image, 60 MB per document (PDF, DOC, DOCX, PPT, PPTX), and 10 MB per caption file (SRT, VTT).

Uploading to S3

After obtaining the signedUrl and key, perform an HTTP PUT request to the signedUrl with the raw file data as the request body. The Content-Type header in this PUT request must match the contentType used to generate the signed URL.

Request body

contentTypestringrequired

The MIME type of the file. Supported image types: image/jpeg, image/png, image/gif, image/webp. Supported video types: video/mp4, video/webm, video/mov, video/quicktime. Supported document types (for LinkedIn document posts only): application/pdf, application/msword (.doc), application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx), application/vnd.ms-powerpoint (.ppt), application/vnd.openxmlformats-officedocument.presentationml.presentation (.pptx). Supported caption types (for YouTube captions only): application/x-subrip (.srt), text/vtt (.vtt); the returned file/ key goes in controls.youtubeCaptionKey, not in mediaItems.

countnumberrequired

Number of signed URLs to generate. Min 1. Max 8 for images, max 1 for videos, max 1 for documents (PDF, DOC, DOCX, PPT, PPTX) and caption files (SRT, VTT).

Response

201 Created An array of objects, each containing:

keystringoptional

The S3 object key for upload.

signedUrlstringoptional

The pre-signed S3 URL for the PUT request.

Request

curl -X POST "https://api.postfa.st/file/get-signed-upload-urls" \
  -H "pf-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contentType": "image/png",
    "count": 2
  }'

Response201 Created

[
  {
    "key": "image/a1b2c3d4-e5f6-7890-1234-567890abcdef.png",
    "signedUrl": "https://s3.amazonaws.com/postfast-uploads/image/a1b2c3d4-e5f6-7890-1234-567890abcdef.png?AWSAccessKeyId=AKIAEXAMPLE&Expires=1640995200&Signature=..."
  },
  {
    "key": "image/b2c3d4e5-f6a7-8901-2345-67890abcdef1.png",
    "signedUrl": "https://s3.amazonaws.com/postfast-uploads/image/b2c3d4e5-f6a7-8901-2345-67890abcdef1.png?AWSAccessKeyId=AKIAEXAMPLE&Expires=1640995200&Signature=..."
  }
]

POST/file/get-signed-upload-urls

Request body

Response

POST`/file/get-signed-upload-urls`