Update File

Update gallery file metadata such as tags or folder assignment.

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

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

200 OK

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