Media

Get upload URL

Changed on

Get a presigned URL to upload files directly to cloud storage (up to 5GB). Returns an uploadUrl and publicUrl. PUT your file to the uploadUrl, then use the publicUrl in your posts.

post/v1/media/presign

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/media/presign
  • Auth: HTTP bearer

Request body

filenamestring required

Name of the file to upload

contentType'image/jpeg' | 'image/jpg' | 'image/png' | 'image/webp' | 'image/gif' | 'video/mp4' | 'video/mpeg' | 'video/quicktime' | 'video/avi' | 'video/x-msvideo' | 'video/webm' | 'video/x-m4v' | 'application/pdf' | 'audio/mpeg' | 'audio/mp4' | 'audio/aac' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/x-m4a' | 'application/x-subrip' | 'text/vtt' required

MIME type of the file to upload. Rejected with a 400 (INVALID_FIELD_VALUE on contentType) when it is not one of these values, so generic types such as application/octet-stream are not accepted here.

sizeinteger

Optional file size in bytes for pre-validation (max 5GB)

Example request

{
  "filename": "my-video.mp4",
  "contentType": "video/mp4",
  "size": 15234567
}

Response

Presigned URL generated successfully

uploadUrlstring uri

Presigned URL to PUT your file to (expires in 1 hour)

publicUrlstring uri

Public URL where the file will be accessible after upload

keystring

Storage key/path of the file

expiresIninteger

Seconds until the presigned uploadUrl expires (always 3600)

Changes

  • 698fd1d46648Revision changes
    • info

      added the new application/x-subrip enum value to the request property

    • info

      added the new text/vtt enum value to the request property

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status