Skip to main content
GET
/
v1
/
customers
/
{id}
/
expose
/
{media_id}
Expose Media
curl --request GET \
  --url https://{defaultHost}/v1/customers/{id}/expose/{media_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "21ea44d2-9206-4f00-bc8e-d7e42a140e25",
  "object": "media",
  "alt": null,
  "byte_size": 12254,
  "content_type": "image/png",
  "extension": "png",
  "filename": "test.png",
  "height": null,
  "public_access": false,
  "release_json": null,
  "title": null,
  "url": "http://app.example.com/file_redirect/eyJfcmFpbHMiOnsiZGF0YSI6IjU5MmNhYjQyLTgwY2EtNDNmMy05NTVhLWVlYjZhZGFmMGU0MiIsImV4cCI6IjIwMjYtMDUtMDVUMjA6MDk6MzMuODY3WiIsInB1ciI6ImJsb2JfaWQifX0=--75e8e50daa6b9ce01f1641941f2dd9b49c7fc1a3/test.png?disposition=attachment",
  "width": null,
  "url_expires_at": 1778011773,
  "created_at": 1778010873,
  "updated_at": 1778010873
}

Documentation Index

Fetch the complete documentation index at: https://developer.surecart.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
media_id
string
required
​
id
string
required

Query Parameters

​
expose_for
integer

Sets how long a private media URL should be valid for, in seconds. The max value allowed is 86400 or 24 hours. When exposing a media through a purchase or license the default value is 900 or 15 minutes.

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
byte_size
integer

The size of the media in bytes.

​
content_type
string

The content type (i.e. image/png, image/jpg, application/pdf).

​
extension
string

The extension (i.e. png, jpg, pdf).

​
filename
string

The full filename with extension.

​
height
string | null

If the media is an image, this will be the height in pixels.

​
public_access
boolean

Whether or not this media is publicly accessible.

​
release_json
object

The JSON that was extracted from the release.json file within the ZIP file.

​
url
string | null

The URL for accessing this media. If the media is public, this will be a permanent URL. If the media is private, this will be a short-lived URL if the media has been exposed.

​
url_expires_at
integer | null

The time at which the URL expires. This will only be present if the media is private and has been exposed.

​
width
string | null

If the media is an image, this will be the width in pixels.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.