Skip to main content

​
Method

GET /v1/products/:id/media

​
Path Parameters

​
id
uuid
required
Product ID.

​
Headers

​
Authorization
string
Bearer token (requires products:read).

​
Request Example

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

​
Response Example

{
  "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.