DUMA/ API

Get an asset

Returns one media file’s metadata: its URL, dimensions, alt text, focal point and smaller copies for srcset.

GEThttps://api.duma-business.com/v1/cms/delivery/assets/{id}

content:readPublishable or secret key

Responses carry a weak ETag; send it back as If-None-Match to get 304 Not Modified. Cache-Control: private, max-age=30, stale-while-revalidate=120.

focalPoint is 0–1 from the left and top, or null. srcset is null when there are no smaller copies.

Request example

Example request
curl -X GET "https://api.duma-business.com/v1/cms/delivery/assets/{id}" \
  -H "Authorization: Bearer dk_pub_…"

Path parameters

idstring (uuid)Required
The asset’s id.

Response

Response · 200
{
  "data": {
    "id": "7d1f3b5a-9c2e-4a6b-8d0f-1e3a5c7b9d2f",
    "fileName": "pumpkin-latte.jpg",
    "mimeType": "image/jpeg",
    "sizeBytes": 412883,
    "width": 1600,
    "height": 1067,
    "title": "Pumpkin spice latte",
    "altText": "A pumpkin spice latte on an oak table",
    "folder": "menu",
    "tags": [
      "autumn",
      "drinks"
    ],
    "createdAt": "2026-09-28T11:04:00.000Z",
    "updatedAt": "2026-09-28T11:06:00.000Z",
    "url": "https://api.duma-business.com/v1/cms/delivery/assets/7d1f3b5a-9c2e-4a6b-8d0f-1e3a5c7b9d2f/file/pumpkin-latte.jpg",
    "focalPoint": {
      "x": 0.5,
      "y": 0.45
    },
    "renditions": [
      {
        "width": 640,
        "height": 427,
        "mimeType": "image/webp",
        "sizeBytes": 38120,
        "url": "https://api.duma-business.com/v1/cms/delivery/assets/7d1f3b5a-9c2e-4a6b-8d0f-1e3a5c7b9d2f/renditions/b3c5d7e9-1f2a-4b4c-8d6e-0f1a3b5c7d9e"
      }
    ],
    "srcset": "https://api.duma-business.com/v1/cms/delivery/assets/7d1f3b5a-9c2e-4a6b-8d0f-1e3a5c7b9d2f/renditions/b3c5d7e9-1f2a-4b4c-8d6e-0f1a3b5c7d9e 640w, https://api.duma-business.com/v1/cms/delivery/assets/7d1f3b5a-9c2e-4a6b-8d0f-1e3a5c7b9d2f/file/pumpkin-latte.jpg 1600w"
  }
}