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

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

https://api.postfa.st/Auth: pf-api-keyRate limit: 350 requests per day, 150 per minuteMaximum 250 MB per video, 10 MB per image, and 60 MB per document (PDF, DOC, DOCX, PPT, PPTX).

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).

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).

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`