Skip to main content

​
Method

PUT /v1/gallery/files/:id

​
Path Parameters

​
id
string
Gallery file ID.

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)
​
content-type
string
application/json

​
Request Example

curl -X PUT "https://api.voyantcloud.com/v1/gallery/files/gal_file_123" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "tags": ["campaign:summer", "channel:web"],
    "folderId": "00000000-0000-0000-0000-000000000000"
  }'

​
Response

{
  "data": {
    "id": "gal_file_123",
    "workspaceId": "ws_abc",
    "name": "ws_abc/banner_summer.png",
    "originalName": "banner_summer.png",
    "size": 245812,
    "mimeType": "image/png",
    "storageProvider": "cf-images",
    "folderId": "00000000-0000-0000-0000-000000000000",
    "metadata": {
      "tags": ["campaign:summer", "channel:web"]
    },
    "status": "completed",
    "publicUrls": {
      "primary": "https://cdn.voyantcloud.com/gallery/ws_abc/banner_summer.png"
    },
    "updatedAt": "2025-02-12T09:30:00.000Z"
  }
}
Updates emit a gallery.file.updated webhook so downstream systems can synchronize metadata.