What is the correct format to pass an array of URLs to the Multi Image field in Webflow's API for updating?
- Use the PATCH or PUT method to update a CMS item at the correct Webflow API endpoint.
- Provide the Multi Image field as an array of
{ "url": "..." }objects using Webflow-hosted image URLs; if needed, upload images first via the Assets API.
To update a Multi Image field in Webflow using the CMS API, you need to pass an array of valid image URLs in a specific format.
1. Use PATCH or PUT for Item Updates
Webflow's CMS API allows updating CMS items using the PATCH or PUT method at the endpoint:
PATCH
https://api.webflow.com/v2/collections/{collection_id}/items/{item_id}
2. Correct Format for Multi Image Field
The value for a Multi Image field must be an array of objects, where each object has a
urlproperty.Example format:
```json
"multiImageFieldSlug": [
{ "url": "https://cdn.prod.website-files.com/path-to-image-1.jpg" },
{ "url": "https://cdn.prod.website-files.com/path-to-image-2.jpg" }
]
```
3. Requirements for URLs
- All image URLs must:
- Be publicly accessible.
- Be hosted on Webflow’s CDN (i.e., start with
https://cdn.prod.website-files.com/). - If images are hosted elsewhere, you must first upload them via the Webflow Assets API or manually add them in Webflow and reference their URLs.
4. Uploading External Images First (if needed)
- If your images are not yet in Webflow, use the assets endpoint of Webflow’s API to upload images and retrieve valid Webflow-hosted URLs.
5. Full API Call Example for Update
- When sending the request, the key for the Multi Image field must match its field slug.
- Ensure headers include your API token and the correct Content-Type (
application/json).
Summary
To update a Multi Image field via Webflow's API, send an array like this: [ { "url": "webflow-image-1.jpg" }, { "url": "webflow-image-2.jpg" } ]. URLs must point to images hosted on Webflow’s CDN.