Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
curl -X POST "https://api.voyantcloud.com/v1/products/prod_123/media" \
-H "Authorization: Bearer $VOYANT_API_KEY" \
-H "content-type: application/json" \
-d '{
"assetId": "asset_01HZY8SM9P8K4B8N7Q",
"kind": "hero",
"alt": "Resort exterior",
"sort": 0
}'
await fetch("https://api.voyantcloud.com/v1/products/prod_123/media", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOYANT_API_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({
url: "https://cdn.example.com/prod_123/gallery-1.jpg",
kind: "gallery",
sort: 1,
}),
})
import os, requests
payload = {
"assetId": "asset_01HZY8SM9P8K4B8N7Q",
"alt": "Lobby area",
"kind": "gallery"
}
resp = requests.post(
"https://api.voyantcloud.com/v1/products/prod_123/media",
headers={
"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}",
"content-type": "application/json",
},
json=payload,
)
created = resp.json()
{
"data": {
"id": "media_01J0E6V4ZBAVQ9PQJRT2P27QX0",
"url": "https://cdn.voyantcloud.com/media/prod_123/hero.jpg",
"kind": "hero",
"alt": "Resort exterior",
"sort": 0,
"assetId": "asset_01HZY8SM9P8K4B8N7Q"
}
}
{
"error": "Validation failed",
"details": [
{ "message": "Either url or assetId must be provided", "path": [] }
]
}
{ "error": "Product not found" }
Attach a media asset to a product via direct URL or Gallery asset.
POST /v1/products/:id/media
url or assetId must be supplied (mediaCreateSchema).
products:write).application/jsoncurl -X POST "https://api.voyantcloud.com/v1/products/prod_123/media" \
-H "Authorization: Bearer $VOYANT_API_KEY" \
-H "content-type: application/json" \
-d '{
"assetId": "asset_01HZY8SM9P8K4B8N7Q",
"kind": "hero",
"alt": "Resort exterior",
"sort": 0
}'
await fetch("https://api.voyantcloud.com/v1/products/prod_123/media", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOYANT_API_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({
url: "https://cdn.example.com/prod_123/gallery-1.jpg",
kind: "gallery",
sort: 1,
}),
})
import os, requests
payload = {
"assetId": "asset_01HZY8SM9P8K4B8N7Q",
"alt": "Lobby area",
"kind": "gallery"
}
resp = requests.post(
"https://api.voyantcloud.com/v1/products/prod_123/media",
headers={
"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}",
"content-type": "application/json",
},
json=payload,
)
created = resp.json()
{
"data": {
"id": "media_01J0E6V4ZBAVQ9PQJRT2P27QX0",
"url": "https://cdn.voyantcloud.com/media/prod_123/hero.jpg",
"kind": "hero",
"alt": "Resort exterior",
"sort": 0,
"assetId": "asset_01HZY8SM9P8K4B8N7Q"
}
}
{
"error": "Validation failed",
"details": [
{ "message": "Either url or assetId must be provided", "path": [] }
]
}
{ "error": "Product not found" }