---
title: "/assets/:assetId/cdnLinks"
method: GET
path: "/v1/assets/{assetId}/cdnLinks"
tags: ["Assets"]
---

# /assets/:assetId/cdnLinks

`GET /v1/assets/{assetId}/cdnLinks`

## Request

- Base URL: `api.air.inc` (relative, and the document’s source URL is not known)
- URL: `api.air.inc/v1/assets/{assetId}/cdnLinks`
- Auth: one of:
  - API key in header `x-api-key` and API key in header `x-air-workspace-id`
  - HTTP bearer and API key in header `x-air-workspace-id`
- TypeScript: <https://skmtc.dev/air/apis/air-api/docs/v1/assets/:assetId/cdnLinks/get.ts> (a function with typed inputs; its response is checked against the schema)

List all CDN links for an asset.

Returns up to 100 links. Evergreen links (`followsDefaultVersion: true`) do not include `versionId`.

## Response `200`

CDN links listed successfully

- object
  - `data` CdnLink[]
    - `id` string, required: The CDN link ID
    - `url` string, uri, required: The public CDN URL for the asset or version
    - `assetId` string, required: The asset this CDN link belongs to
    - `followsDefaultVersion` boolean, required: When true, the link serves the asset's current default version. When false, the link is pinned to a specific version (`versionId`).
    - `active` boolean, required: Whether the CDN link is active and serving content
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `versionId` string: Present when `followsDefaultVersion` is false — the pinned asset version ID

## Other responses

- `404`: Asset not found
- `422`: CDN Links are not enabled for this workspace

---

[API](https://skmtc.dev/air/apis/air-api.md) - [All operations](https://skmtc.dev/air/apis/air-api/llms.txt) - [OpenAPI document](https://skmtc.dev/air/apis/air-api/revisions/8e6005b272a1?raw)