List up to 100 images with one request. Use the optional parameters below to get a specific range of images.

Fetch details for a single image.

Upload an image with up to 10 Megabytes using a single HTTP POST (multipart/form-data) request. An image can be uploaded by sending an image file or passing an accessible to an API url.

Update image access control. On access control change, all copies of the image are purged from cache.

Delete an image on Cloudflare Images. On success, all copies of the image are deleted and purged from cache.

Fetch base image. For most images this will be the originally uploaded file. For larger images it can be a near-lossless version of the original.

Lists your signing keys. These can be found on your Cloudflare Images dashboard.

Create a new signing key with specified name. Returns all keys available.

Delete signing key with specified name. Returns all keys available. When last key is removed, a new default signing key will be generated.

Fetch image statistics details for Cloudflare Images. The returned statistics detail storage usage, including the current image count vs this account's allowance.

Lists existing variants.

Fetch details for a single variant.

Specify variants that allow you to resize images for different use cases.

Updating a variant purges the cache for all images associated with the variant.

Deleting a variant purges the cache for all images associated with the variant.

List up to 10000 images with up to 1000 results per page. Use the optional parameters below to get a specific range of images. Pagination is supported via continuation_token.

Metadata Filtering (Optional):

You can optionally filter images by custom metadata fields using the meta.<field>[<operator>]=<value> syntax.

Supported Operators:

• eq / eq:string / eq:number / eq:boolean - Exact match
• in / in:string / in:number - Match any value in list (pipe-separated)

Metadata Filter Constraints:

• Maximum 5 metadata filters per request
• Maximum 5 levels of nesting (e.g., meta.first.second.third.fourth.fifth)
• Maximum 10 elements for list operators (in)
• Supports string, number, and boolean value types

Examples:

# List all images
/images/v2

# Filter by metadata [eq]
/images/v2?meta.status[eq:string]=active

# Filter by metadata [in]
/images/v2?meta.status[in]=pending|deleted|flagged

# Filter by metadata [in:number]
/images/v2?meta.ratings[in:number]=4|5

# Filter by nested metadata
/images/v2?meta.region.name[eq]=eu-west

# Combine metadata filters with creator
/images/v2?meta.status[eq]=active&creator=user123

# Multiple metadata filters (AND logic)
/images/v2?meta.status[eq]=active&meta.priority[eq:number]=5

Direct uploads allow users to upload images without API keys. A common use case are web apps, client-side applications, or mobile devices where users upload content directly to Cloudflare Images. This method creates a draft record for a future image. It returns an upload URL and an image identifier. To verify if the image itself has been uploaded, send an image details request (accounts/:account_identifier/images/v1/:identifier), and check that the draft: true property is not present.