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": "f8f3291d-3daa-4772-a1cd-02c7b209b822",
  "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/eyJfcmFpbHMiOnsiZGF0YSI6IjUwM2YzMDMxLWE4ZjEtNGQwZS05N2VmLTQyY2I4OTE0ZTMzZCIsImV4cCI6IjIwMjYtMDEtMDhUMjI6MTY6MzQuNTcxWiIsInB1ciI6ImJsb2JfaWQifX0=--596d302c66c9dd1f88911794d446d6aebcda3c0f/test.png?disposition=attachment",
  "width": null,
  "url_expires_at": 1767910594,
  "created_at": 1767909693,
  "updated_at": 1767909693
}

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.