Media

The CDA (Content Delivery API) is a read-only API that delivers published resources to public visitors. This page covers how to read published Media, that is, file assets such as images, videos, and documents, and how to obtain their delivery addresses. Because CDA delivers a snapshot from the time of publishing, Media that has not yet been published in the content studio does not appear here.

CDA has only read (GET) endpoints; uploading, editing, and publishing Media is the responsibility of CMA Media. For CDA's common behavior, such as authentication and the published delivery model (the published snapshot, revision, and published-only visibility), see the CDA overview. Unlike the other published resources, Media always omits author information (createdBy and updatedBy). title, description, and file come back as single values resolved for the requested locale.

Resource structure

The following is how CDA delivers, in a single read with locale=en-US, one published Media from the demo Space (a product photo of the "Stainless Tumbler 500ml"). Along with sys (system properties), it has fields, which holds the title, description, and file resolved for that locale.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7PBe7ehkOn8e",
    "type": "Media",
    "space": { "sys": { "id": "tcq4V2Xb", "type": "Refer", "targetType": "Space" } },
    "createdAt": "2026-06-17T17:07:13.154Z",
    "updatedAt": "2026-06-17T17:07:13.384Z",
    "revision": 1
  },
  "fields": {
    "title": "Stainless Tumbler 500ml front shot",
    "description": "Front product shot of the tumbler on a white background.",
    "file": {
      "fileName": "tumbler.png",
      "contentType": "image/png",
      "mimeGroups": ["Image"],
      "url": "https://weegloo-media.com/medias/tcq4V2Xb/n8e/3trmXRM3RqbgSnifyg7PBe7ehkOn8e/en-US/1/tumbler.png",
      "detail": {
        "size": 50847,
        "image": { "width": 900, "height": 900 }
      }
    }
  }
}

Key properties:

• sys.id: The unique identifier of the Media. It goes into {mediaId} in the single-read path.
• sys.revision: The version at the time it was published. Because CDA does not carry the management version, revision is the only value that points to the published version.
• fields.title and fields.description: Single values resolved for the requested locale (not locale maps).
• fields.file: An object representing the one file for that locale. The delivery address for showing the file to a visitor is file.url. The object keys are described in fields below.

System properties (sys)

The sys of a published Media carries only properties for the published snapshot. space is in the Refer shape ({ "sys": { "id", "type": "Refer", "targetType" } }).

Because this is a published snapshot, the version, status, publish, and archive found in CMA's sys are not carried. revision is the only value that points to the published version. Author information (createdBy and updatedBy) is also always omitted from the delivery response.

fields

fields holds single values resolved for the requested locale. Unlike CMA, which returns a map holding every per-locale value such as fields.title.ko-KR, CDA picks the value for the one requested locale and places it directly.

The keys of the file object are as follows.

API

The base URL for the two endpoints below is https://cda.weegloo.com/v1, and a Bearer token that authenticates against CDA is required in the Authorization header. Both endpoints choose the language to receive with the locale query parameter: a code such as locale=ko-KR returns values for that locale, omitting it uses the Space's default Locale, and locale=* returns the full locale map. In the first two cases, the response carries an x-weegloo-locale header that reports the locale actually used.

Related documents

• CDA Content: Published Content that references Media.
• CMA Media: The API for uploading and managing Media.
• Media (concept): How to work with file assets in the content studio.