Samva
DashboardAPI
ChannelsPlatformDevelopersEmail templatesIntegrationsAPI Reference
Media

Get a media download URL

Generates a presigned, time-limited download URL for a ready media object. Use this endpoint to get a media download URL through the Samva email API.

GET
/v1/media/{mediaId}/url

Generates a presigned, time-limited download URL for a ready media object.

Authorization

apiKey
x-api-key<token>

In: header

Path Parameters

mediaId*string
Match^media_[0-9a-hjkmnp-tv-z]{16,24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/media/string/url"
{  "url": "string",  "expiresAt": "string"}

Create a media object

Creates the media object in the pending state and returns it with the upload instruction; URL, method, and headers; for putting its bytes into storage.

Get a media object

Returns the media object's metadata, including status, dimensions, and confirmation timestamps.