--- title: V1 --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Images](https://developers.cloudflare.com/api/python/resources/images) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # V1 ##### [List images](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/methods/list) Deprecated images.v1.list(V1ListParams\*\*kwargs) -> SyncV4PagePagination\[[V1ListResponse]()] GET/accounts/{account\_id}/images/v1 ##### [Image details](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/methods/get) images.v1.get(strimage\_id, V1GetParams\*\*kwargs) -> [Image]() GET/accounts/{account\_id}/images/v1/{image\_id} ##### [Upload an image](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/methods/create) images.v1.create(V1CreateParams\*\*kwargs) -> [Image]() POST/accounts/{account\_id}/images/v1 ##### [Update image](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/methods/edit) images.v1.edit(strimage\_id, V1EditParams\*\*kwargs) -> [Image]() PATCH/accounts/{account\_id}/images/v1/{image\_id} ##### [Delete image](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/methods/delete) images.v1.delete(strimage\_id, V1DeleteParams\*\*kwargs) -> [V1DeleteResponse]() DELETE/accounts/{account\_id}/images/v1/{image\_id} ##### ModelsExpand Collapse
class Image: … id: Optional\[str] Image unique identifier. maxLength32 Link to this property creator: Optional\[str] Can set the creator field with an internal user ID. maxLength1024 Link to this property filename: Optional\[str] Image file name. maxLength255 Link to this property meta: Optional\[object] User modifiable key-value store. Can be used for keeping references to another system of record for managing images. Metadata must not exceed 1024 bytes. Link to this property require\_signed\_urls: Optional\[bool] Indicates whether the image can be a accessed only using it’s UID. If set to true, a signed token needs to be generated with a signing key to view the image. Link to this property uploaded: Optional\[datetime] When the media item was uploaded. formatdate-time Link to this property variants: Optional\[List\[str]] Object specifying available variants for an image. Link to this property
[Link to this property](<#(resource)%20images.v1%20%3E%20(model)%20image%20%3E%20(schema)>)
class V1ListResponse: …
images: Optional\[List\[Image]] id: Optional\[str] Image unique identifier. maxLength32 Link to this property creator: Optional\[str] Can set the creator field with an internal user ID. maxLength1024 Link to this property filename: Optional\[str] Image file name. maxLength255 Link to this property meta: Optional\[object] User modifiable key-value store. Can be used for keeping references to another system of record for managing images. Metadata must not exceed 1024 bytes. Link to this property require\_signed\_urls: Optional\[bool] Indicates whether the image can be a accessed only using it’s UID. If set to true, a signed token needs to be generated with a signing key to view the image. Link to this property uploaded: Optional\[datetime] When the media item was uploaded. formatdate-time Link to this property variants: Optional\[List\[str]] Object specifying available variants for an image. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1%20%3E%20(model)%20v1_list_response%20%3E%20(schema)>)
Union\[str, object] One of the following: str Link to this property object Link to this property
[Link to this property](<#(resource)%20images.v1%20%3E%20(model)%20v1_delete_response%20%3E%20(schema)>) #### V1Keys ##### [List Signing Keys](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/keys/methods/list) images.v1.keys.list(KeyListParams\*\*kwargs) -> [KeyListResponse]() GET/accounts/{account\_id}/images/v1/keys ##### [Create a new Signing Key](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/keys/methods/update) images.v1.keys.update(strsigning\_key\_name, KeyUpdateParams\*\*kwargs) -> [KeyUpdateResponse]() PUT/accounts/{account\_id}/images/v1/keys/{signing\_key\_name} ##### [Delete Signing Key](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/keys/methods/delete) images.v1.keys.delete(strsigning\_key\_name, KeyDeleteParams\*\*kwargs) -> [KeyDeleteResponse]() DELETE/accounts/{account\_id}/images/v1/keys/{signing\_key\_name} ##### ModelsExpand Collapse
class Key: … name: Optional\[str] Key name. Link to this property value: Optional\[str] Key value. Link to this property
[Link to this property](<#(resource)%20images.v1.keys%20%3E%20(model)%20key%20%3E%20(schema)>)
class KeyListResponse: …
keys: Optional\[List\[Key]] name: Optional\[str] Key name. Link to this property value: Optional\[str] Key value. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.keys%20%3E%20(model)%20key_list_response%20%3E%20(schema)>)
class KeyUpdateResponse: …
keys: Optional\[List\[Key]] name: Optional\[str] Key name. Link to this property value: Optional\[str] Key value. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.keys%20%3E%20(model)%20key_update_response%20%3E%20(schema)>)
class KeyDeleteResponse: …
keys: Optional\[List\[Key]] name: Optional\[str] Key name. Link to this property value: Optional\[str] Key value. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.keys%20%3E%20(model)%20key_delete_response%20%3E%20(schema)>) #### V1Stats ##### [Images usage statistics](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/stats/methods/get) images.v1.stats.get(StatGetParams\*\*kwargs) -> [Stat]() GET/accounts/{account\_id}/images/v1/stats ##### ModelsExpand Collapse
class Stat: …
count: Optional\[Count] allowed: Optional\[float] Cloudflare Images allowed usage. Link to this property current: Optional\[float] Cloudflare Images current usage. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.stats%20%3E%20(model)%20stat%20%3E%20(schema)>) #### V1Variants ##### [List variants](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/variants/methods/list) images.v1.variants.list(VariantListParams\*\*kwargs) -> [Variant]() GET/accounts/{account\_id}/images/v1/variants ##### [Variant details](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/variants/methods/get) images.v1.variants.get(strvariant\_id, VariantGetParams\*\*kwargs) -> [VariantGetResponse]() GET/accounts/{account\_id}/images/v1/variants/{variant\_id} ##### [Create a variant](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/variants/methods/create) images.v1.variants.create(VariantCreateParams\*\*kwargs) -> [VariantCreateResponse]() POST/accounts/{account\_id}/images/v1/variants ##### [Update a variant](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/variants/methods/edit) images.v1.variants.edit(strvariant\_id, VariantEditParams\*\*kwargs) -> [VariantEditResponse]() PATCH/accounts/{account\_id}/images/v1/variants/{variant\_id} ##### [Delete a variant](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/variants/methods/delete) images.v1.variants.delete(strvariant\_id, VariantDeleteParams\*\*kwargs) -> [VariantDeleteResponse]() DELETE/accounts/{account\_id}/images/v1/variants/{variant\_id} ##### ModelsExpand Collapse
class Variant: …
variants: Optional\[Variants]
hero: Optional\[VariantsHero] id: str maxLength99 Link to this property
options: VariantsHeroOptions Allows you to define image resizing sizes for different use cases.
fit: Literal\["scale-down", "contain", "cover", 2 more] The fit property describes how the width and height dimensions should be interpreted. One of the following: "scale-down" Link to this property "contain" Link to this property "cover" Link to this property "crop" Link to this property "pad" Link to this property
Link to this property height: float Maximum height in image pixels. minimum1 Link to this property
metadata: Literal\["keep", "copyright", "none"] What EXIF data should be preserved in the output image. One of the following: "keep" Link to this property "copyright" Link to this property "none" Link to this property
Link to this property width: float Maximum width in image pixels. minimum1 Link to this property
Link to this property never\_require\_signed\_urls: Optional\[bool] Indicates whether the variant can access an image without a signature, regardless of image access control. Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(model)%20variant%20%3E%20(schema)>)
class VariantGetResponse: …
variant: Optional\[Variant] id: str maxLength99 Link to this property
options: VariantOptions Allows you to define image resizing sizes for different use cases.
fit: Literal\["scale-down", "contain", "cover", 2 more] The fit property describes how the width and height dimensions should be interpreted. One of the following: "scale-down" Link to this property "contain" Link to this property "cover" Link to this property "crop" Link to this property "pad" Link to this property
Link to this property height: float Maximum height in image pixels. minimum1 Link to this property
metadata: Literal\["keep", "copyright", "none"] What EXIF data should be preserved in the output image. One of the following: "keep" Link to this property "copyright" Link to this property "none" Link to this property
Link to this property width: float Maximum width in image pixels. minimum1 Link to this property
Link to this property never\_require\_signed\_urls: Optional\[bool] Indicates whether the variant can access an image without a signature, regardless of image access control. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(model)%20variant_get_response%20%3E%20(schema)>)
class VariantCreateResponse: …
variant: Optional\[Variant] id: str maxLength99 Link to this property
options: VariantOptions Allows you to define image resizing sizes for different use cases.
fit: Literal\["scale-down", "contain", "cover", 2 more] The fit property describes how the width and height dimensions should be interpreted. One of the following: "scale-down" Link to this property "contain" Link to this property "cover" Link to this property "crop" Link to this property "pad" Link to this property
Link to this property height: float Maximum height in image pixels. minimum1 Link to this property
metadata: Literal\["keep", "copyright", "none"] What EXIF data should be preserved in the output image. One of the following: "keep" Link to this property "copyright" Link to this property "none" Link to this property
Link to this property width: float Maximum width in image pixels. minimum1 Link to this property
Link to this property never\_require\_signed\_urls: Optional\[bool] Indicates whether the variant can access an image without a signature, regardless of image access control. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(model)%20variant_create_response%20%3E%20(schema)>)
class VariantEditResponse: …
variant: Optional\[Variant] id: str maxLength99 Link to this property
options: VariantOptions Allows you to define image resizing sizes for different use cases.
fit: Literal\["scale-down", "contain", "cover", 2 more] The fit property describes how the width and height dimensions should be interpreted. One of the following: "scale-down" Link to this property "contain" Link to this property "cover" Link to this property "crop" Link to this property "pad" Link to this property
Link to this property height: float Maximum height in image pixels. minimum1 Link to this property
metadata: Literal\["keep", "copyright", "none"] What EXIF data should be preserved in the output image. One of the following: "keep" Link to this property "copyright" Link to this property "none" Link to this property
Link to this property width: float Maximum width in image pixels. minimum1 Link to this property
Link to this property never\_require\_signed\_urls: Optional\[bool] Indicates whether the variant can access an image without a signature, regardless of image access control. Link to this property
Link to this property
[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(model)%20variant_edit_response%20%3E%20(schema)>)
Union\[str, object] One of the following: str Link to this property object Link to this property
[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(model)%20variant_delete_response%20%3E%20(schema)>) #### V1Blobs ##### [Download image](https://developers.cloudflare.com/api/python/resources/images/subresources/v1/subresources/blobs/methods/get) images.v1.blobs.get(strimage\_id, BlobGetParams\*\*kwargs) -> BinaryResponseContent GET/accounts/{account\_id}/images/v1/{image\_id}/blob