Uploads

Copy a file from a public URL into your uploads

For clients that cannot send file bytes. The server downloads the URL (public addresses only), checks the type from the bytes and the size against your plan's upload limit, and stores it under uploads/{user_id}/{uuid}.{ext}. 30 imports per hour. Behind the MEDIA_UPLOAD_FROM_URL feature flag (403 feature_disabled while off).

post/uploads/from-url

Request

  • Base URL: https://www.sociahive.com/api/v1
  • URL: https://www.sociahive.com/api/v1/uploads/from-url
  • Auth: one of:
    • API key in header X-API-Key
    • OAuth 2 (authorization code, authorization URL /api/oauth/authorize, token URL /api/oauth/token, scopes: uploads:write)

Request body

urlstring uri required

Public http(s) URL of a JPEG, PNG, WebP, MP4 or MOV file.

Example request

{
  "url": "https://images.example.com/slide-1.jpg"
}

Response

Stored copy

urlstring uri required

Public URL of the stored copy. Use it as post media.

keystring required
size_bytesinteger required
mime_type'image/jpeg' | 'image/png' | 'image/webp' | 'video/mp4' | 'video/quicktime' required

Changes

No recorded changes to this operation across all 1 revision of this API.