Get a presigned media upload URL

Returns a presigned S3 PUT URL for client-side media upload. Upload the file directly via HTTP PUT to the returned URL, then call POST /v1/media/:id/verify to confirm.

GET /media/upload-url

Get a presigned media upload URL

cURL

curl --request GET \
  --url https://api.social-api.ai/v1/media/upload-url \
  --header 'Authorization: <api-key>'

200

{
  "expires_at": "2026-03-14T09:15:00Z",
  "media_id": "<string>",
  "upload_url": "<string>"
}

Authorizations

Authorization · string · header · required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Query Parameters

media_type · string · required

MIME type (e.g. image/jpeg)

filename · string · required

Original filename

Response

200

application/json

OK

expires_at · string

Example:

"2026-03-14T09:15:00Z"

media_id · string

upload_url · string