Cloudflare Images - Manage hosted images with the Images binding

Use the Images binding to upload, list, retrieve, update, and delete images stored in Images directly from your Worker without managing API tokens or making HTTP requests.

The env.IMAGES.hosted namespace supports the following storage and management operations:

• .upload(image, options) — Upload a new image to your account.
• .list(options) — List images with pagination.
• .image(imageId).details() — Get image metadata.
• .image(imageId).bytes() — Stream the original image bytes.
• .image(imageId).update(options) — Update metadata or access controls.
• .image(imageId).delete() — Delete an image.

For example, you can upload an image from a request body and return its metadata:

<div><div><span>const</span><span> </span><span>image</span><span> </span><span>=</span><span> </span><span>await</span><span> </span><span>env</span><span>.</span><span>IMAGES</span><span>.</span><span>hosted</span><span>.</span><span>upload</span><span>(</span><span>request</span><span>.</span><span>body</span><span>,</span><span> </span><span>{</span></div></div><div><div><span><span>  </span></span><span>filename</span><span>:</span><span> </span><span>"upload.jpg"</span><span>,</span></div></div><div><div><span><span>  </span></span><span>metadata</span><span>:</span><span> </span><span>{</span><span> source</span><span>:</span><span> </span><span>"worker"</span><span> </span><span>},</span></div></div><div><div><span>}</span><span>)</span><span>;</span></div></div><div><div>
</div></div><div><div><span>return</span><span> </span><span>Response</span><span>.</span><span>json</span><span>(</span><span>image</span><span>)</span><span>;</span></div></div>

Or retrieve and serve the original bytes of a hosted image:

<div><div><span>const</span><span> </span><span>bytes</span><span> </span><span>=</span><span> </span><span>await</span><span> </span><span>env</span><span>.</span><span>IMAGES</span><span>.</span><span>hosted</span><span>.</span><span>image</span><span>(</span><span>"IMAGE_ID"</span><span>)</span><span>.</span><span>bytes</span><span>()</span><span>;</span></div></div><div><div><span>return</span><span> </span><span>new</span><span> </span><span>Response</span><span>(</span><span>bytes</span><span>)</span><span>;</span></div></div>

For more information, refer to the Images binding.