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

# /assets/:assetId/cdnLinks

`POST /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/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a CDN link for an asset.

Use `followsDefaultVersion: true` for an evergreen link that tracks the asset's current default version, or `versionId` to pin the link to a specific version.

Returns `409 Conflict` if a link already exists. Use `GET /v1/assets/{assetId}/cdnLinks` to retrieve the existing link.

## Request body

- union: Specify exactly one of `followsDefaultVersion` or `versionId`
  - object
    - `followsDefaultVersion` true, required: Create a CDN link that follows the asset's default version
  - object
    - `versionId` string, uuid, required: Pin the CDN link to this asset version

## Response `201`

CDN link created successfully

- 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

- `400`: Invalid request body, asset too large for CDN links, or missing storage location
- `404`: Asset or version not found
- `409`: A CDN link already exists for this asset or version
- `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)