# Upload

Each media object you upload to the Media Area of your DatoCMS project is represented as an `upload` entity.

## Object payload

id string

RFC 4122 UUID of upload expressed in URL-safe base64 format

Example: `"q0VNpiNQSkG6z0lif_O1zg"`

type string

Must be exactly `"upload"`.

size integer

size of the upload

Example: `444`

width null, integer

Width of image

Example: `30`

height null, integer

Height of image

Example: `30`

path string

Upload path

Example: `"/45/1496845848-digital-cats.jpg"`

basename string

Upload basename

Example: `"digital-cats"`

filename string

Upload filename

Example: `"digital-cats.jpg"`

url string

Upload URL

Example: `"https://www.datocms-assets.com/45/1496845848-digital-cats.jpg"`

format string, null

Format

Example: `"jpg"`

author string, null

Author

Example: `"Mark Smith"`

copyright string, null

Copyright

Example: `"2020 DatoCMS"`

notes string, null

Notes

Example: `"Nyan the cat"`

md5 string

The MD5 hash of the asset

Example: `"873c296d0f2b7ee569f2d7ddaebc0d33"`

duration integer, null

Seconds of duration for the video

Example: `62`

frame\_rate integer, null

Frame rate (FPS) for the video

Example: `30`

blurhash string, null

Blurhash for the asset

Example: `"LEHV6nWB2yk8pyo0adR*.7kCMdnj"`

thumbhash string, null

Base64 encoded ThumbHash for the asset

Example: `"UhqCDQIkrHOfVG8wBa2v39z7CXeqZWFLdg=="`

mux\_playback\_id string, null

Public Mux playback ID. Used with stream.mux.com to create the source URL for a video player.

Example: `"a1B2c3D4e5F6g7H8i9"`

mux\_mp4\_highest\_res enum, null

Maximum quality of MP4 rendition available

Example: `"high"`

Show enum values

high

medium

low

default\_field\_metadata object

For each of the project's locales, the default metadata to apply if nothing is specified at record's level.

Example: `{ en: { title: "this is the default title", alt: "this is the default alternate text", custom_data: { foo: "bar" }, focal_point: { x: 0.5, y: 0.5 }, }, }`

is\_image boolean

Is this upload an image?

created\_at

Date of upload

Type: null, date-time

updated\_at

Date of last update

Type: null, date-time

mime\_type null, string

Mime type of upload

Example: `"image/jpeg"`

tags

Tags

Type: Array<string>

Example: `["cats"]`

smart\_tags

Smart tags

Type: Array<string>

Example: `["robot-cats"]`

exif\_info object

Exif information

Example: `{ iso: 10000, model: "ILCE-7", flash_mode: 16, focal_length: 35, exposure_time: 0.0166667, }`

colors

Dominant colors of the image

Type: Array<object>

Example: `[ { red: 206, green: 203, blue: 167, alpha: 255 }, { red: 158, green: 163, blue: 93, alpha: 255 }, ]`

Show objects format inside array

red integer

Red value (from 0 to 255)

Example: `115`

green integer

Green value (from 0 to 255)

Example: `133`

blue integer

Blue value (from 0 to 255)

Example: `27`

alpha integer

Alpha value (from 0 to 255)

Example: `255`

creator

The entity (account/collaborator/access token) who created the asset

Type: [ResourceLinkage<"account">](https://www.datocms.com/docs/content-management-api/resources/account.md), [ResourceLinkage<"access\_token">](https://www.datocms.com/docs/content-management-api/resources/access_token.md), [ResourceLinkage<"user">](https://www.datocms.com/docs/content-management-api/resources/user.md), [ResourceLinkage<"sso\_user">](https://www.datocms.com/docs/content-management-api/resources/sso_user.md), [ResourceLinkage<"organization">](https://www.datocms.com/docs/content-management-api/resources/organization.md)

upload\_collection

Upload collection to which the asset belongs

Type: [ResourceLinkage<"upload\_collection">](https://www.datocms.com/docs/content-management-api/resources/upload_collection.md), null

## Available endpoints

-   [Create a new upload](https://www.datocms.com/docs/content-management-api/resources/upload/create.md)

-   [List all uploads](https://www.datocms.com/docs/content-management-api/resources/upload/instances.md)
-   [Retrieve an upload](https://www.datocms.com/docs/content-management-api/resources/upload/self.md)

-   [Delete an upload](https://www.datocms.com/docs/content-management-api/resources/upload/destroy.md)
-   [Update an upload](https://www.datocms.com/docs/content-management-api/resources/upload/update.md)

-   [Referenced records](https://www.datocms.com/docs/content-management-api/resources/upload/references.md)
-   [Add tags to assets in bulk](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_tag.md)

-   [Put assets into a collection in bulk](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_set_upload_collection.md)
-   [Destroy uploads](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_destroy.md)

## Related content in "Content Management API"

- [Content Management API Overview](https://www.datocms.com/docs/content-management-api.md)

- [Using the JavaScript client](https://www.datocms.com/docs/content-management-api/using-the-nodejs-clients.md)
- [API versioning](https://www.datocms.com/docs/content-management-api/api-versioning.md)

- [Authentication](https://www.datocms.com/docs/content-management-api/authentication.md)
- [Environments](https://www.datocms.com/docs/content-management-api/setting-the-environment.md)

- [Error codes & handling failures (CMA)](https://www.datocms.com/docs/content-management-api/errors.md)
- [Pagination](https://www.datocms.com/docs/content-management-api/pagination.md)

- [Asynchronous jobs](https://www.datocms.com/docs/content-management-api/async-jobs.md)
- [Technical Limits (CMA)](https://www.datocms.com/docs/content-management-api/technical-limits.md)

- [Record](https://www.datocms.com/docs/content-management-api/resources/item.md)
- [Scheduled publication](https://www.datocms.com/docs/content-management-api/resources/scheduled-publication.md)

- [Scheduled unpublishing](https://www.datocms.com/docs/content-management-api/resources/scheduled-unpublishing.md)
- [Upload](https://www.datocms.com/docs/content-management-api/resources/upload.md)

- [Create a new upload](https://www.datocms.com/docs/content-management-api/resources/upload/create.md)
- [List all uploads](https://www.datocms.com/docs/content-management-api/resources/upload/instances.md)

- [Retrieve an upload](https://www.datocms.com/docs/content-management-api/resources/upload/self.md)
- [Delete an upload](https://www.datocms.com/docs/content-management-api/resources/upload/destroy.md)

- [Update an upload](https://www.datocms.com/docs/content-management-api/resources/upload/update.md)
- [Referenced records](https://www.datocms.com/docs/content-management-api/resources/upload/references.md)

- [Add tags to assets in bulk](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_tag.md)
- [Put assets into a collection in bulk](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_set_upload_collection.md)

- [Destroy uploads](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_destroy.md)
- [Site](https://www.datocms.com/docs/content-management-api/resources/site.md)

- [Model/Block](https://www.datocms.com/docs/content-management-api/resources/item-type.md)
- [Field](https://www.datocms.com/docs/content-management-api/resources/field.md)

- [Fieldset](https://www.datocms.com/docs/content-management-api/resources/fieldset.md)
- [Record version](https://www.datocms.com/docs/content-management-api/resources/item-version.md)

- [Upload permission](https://www.datocms.com/docs/content-management-api/resources/upload-request.md)
- [Upload track](https://www.datocms.com/docs/content-management-api/resources/upload-track.md)

- [Manual tags](https://www.datocms.com/docs/content-management-api/resources/upload-tag.md)
- [Smart tags](https://www.datocms.com/docs/content-management-api/resources/upload-smart-tag.md)

- [Upload Collection](https://www.datocms.com/docs/content-management-api/resources/upload-collection.md)
- [Search result](https://www.datocms.com/docs/content-management-api/resources/search-result.md)

- [Environment](https://www.datocms.com/docs/content-management-api/resources/environment.md)
- [Maintenance mode](https://www.datocms.com/docs/content-management-api/resources/maintenance-mode.md)

- [Menu Item](https://www.datocms.com/docs/content-management-api/resources/menu-item.md)
- [Schema Menu Item](https://www.datocms.com/docs/content-management-api/resources/schema-menu-item.md)

- [Uploads filter](https://www.datocms.com/docs/content-management-api/resources/upload-filter.md)
- [Model filter](https://www.datocms.com/docs/content-management-api/resources/item-type-filter.md)

- [Plugin](https://www.datocms.com/docs/content-management-api/resources/plugin.md)
- [Workflow](https://www.datocms.com/docs/content-management-api/resources/workflow.md)

- [Asynchronous job](https://www.datocms.com/docs/content-management-api/resources/job.md)
- [Job result](https://www.datocms.com/docs/content-management-api/resources/job-result.md)

- [Account](https://www.datocms.com/docs/content-management-api/resources/account.md)
- [Organization](https://www.datocms.com/docs/content-management-api/resources/organization.md)

- [Invitation](https://www.datocms.com/docs/content-management-api/resources/site-invitation.md)
- [Collaborator](https://www.datocms.com/docs/content-management-api/resources/user.md)

- [Role](https://www.datocms.com/docs/content-management-api/resources/role.md)
- [API token](https://www.datocms.com/docs/content-management-api/resources/access-token.md)

- [Webhook](https://www.datocms.com/docs/content-management-api/resources/webhook.md)
- [Webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call.md)

- [Build trigger](https://www.datocms.com/docs/content-management-api/resources/build-trigger.md)
- [Deploy activity](https://www.datocms.com/docs/content-management-api/resources/build-event.md)

- [Subscription limit](https://www.datocms.com/docs/content-management-api/resources/subscription-limit.md)
- [Subscription feature](https://www.datocms.com/docs/content-management-api/resources/subscription-feature.md)

- [SSO Settings](https://www.datocms.com/docs/content-management-api/resources/sso-settings.md)
- [SSO User](https://www.datocms.com/docs/content-management-api/resources/sso-user.md)

- [SSO Group](https://www.datocms.com/docs/content-management-api/resources/sso-group.md)
- [White-label settings](https://www.datocms.com/docs/content-management-api/resources/white-label-settings.md)

- [Audit log event](https://www.datocms.com/docs/content-management-api/resources/audit-log-event.md)