Skip to main content
POST
/
v1
/
medias
Create
curl --request POST \
  --url https://{defaultHost}/v1/medias \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "media": {
    "direct_upload_signed_id": "eyJfcmFpbHMiOnsiZGF0YSI6IjE0ZjYwNmQzLTNiOTEtNGVhOS1hNWM3LTBmYzIzOTc1ZTJiNyIsInB1ciI6ImJsb2JfaWQifX0=--daa2ef9c00fdd3fbc4ffbfdd0e6f99a5c62a5c4a"
  }
}
'
{
  "id": "d57c3fcd-83a0-4e47-b798-31e58a126407",
  "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": null,
  "width": null,
  "url_expires_at": null,
  "created_at": 1767909724,
  "updated_at": 1767909724
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
media
object

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.