Home
Content Management API
Main resources
Upload-related
Site Search
Environments
UI
Workflows
Async jobs
Roles & permissions
Webhooks
Hosting & CI integrations
Subscription
Enterprise
    Choose your language:
    Upload

    Every file you upload to DatoCMS will be retrievable from this endpoint.

    Object payload
    id  string
    ID of upload
    size  integer

    size of the upload

    width  null, integer

    Width of image

    height  null, integer

    Height of image

    path  string

    Upload path

    basename  string

    Upload basename

    filename  string

    Upload filename

    url  string

    Upload URL

    format  string, null

    Format

    author  string, null

    Author

    copyright  string, null

    Copyright

    notes  string, null

    Notes

    md5  string

    The MD5 hash of the asset

    duration  integer, null

    Seconds of duration for the video

    frameRate  integer, null

    Frame rate (FPS) for the video

    blurhash  string, null

    Blurhash for the asset

    muxPlaybackId  string, null

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

    muxMp4HighestRes  enum, null

    Maximum quality of MP4 rendition available

    defaultFieldMetadata  object

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

    isImage  boolean

    Is this upload an image?

    createdAt  null, date-time

    Date of upload

    updatedAt  null, date-time

    Date of last update

    mimeType  null, string

    Mime type of upload

    tags  Array<string>

    Tags

    smartTags  Array<string>

    Smart tags

    exifInfo  object

    Exif information

    colors  Array<object>

    Dominant colors of the image

    relationships.creator  { type: "account", id: account.id }, { type: "access_token", id: access_token.id }, { type: "user", id: user.id }, { type: "sso_user", id: sso_user.id }

    The entity (account/collaborator/access token) who created the asset. It must be an object with type (e.g. 'account') and id properties.

    Available endpoints

    Questions?
    We're always happy to help with code or other questions you might have. Search our documentation, forum, contact support, or connect with our sales team. You can chat live with other developers in our Slack channel.