List Product Media

Retrieve media items assigned to a product in sort order.

Method

GET /v1/products/:id/media

Path Parameters

id · uuid · required

Product ID.

Headers

Authorization · string

Bearer token (requires products:read).

Request Example

cURL

curl "https://api.voyantcloud.com/v1/products/prod_123/media" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

Response Example

200 OK

{
  "data": [
    {
      "id": "media_01J0E6V4ZBAVQ9PQJRT2P27QX0",
      "url": "https://cdn.voyantcloud.com/media/prod_123/cover.jpg",
      "kind": "hero",
      "alt": "Ocean view room",
      "sort": 0,
      "assetId": "asset_01HZY8SM9P8K4B8N7Q"
    },
    {
      "id": "media_01J0E6V4ZBAVQ9PQJRTR6K9HQC",
      "url": "https://cdn.voyantcloud.com/media/prod_123/pool.jpg",
      "kind": "gallery",
      "alt": null,
      "sort": 1,
      "assetId": null
    }
  ]
}

Items are returned in ascending sort order. Each record includes the resolved url, optional assetId, and metadata.