Cloudflare API | Images › V2 › Direct Uploads › Create Authenticated Direct Upload URL V2

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.

Delete Image -> Envelope<unknown | string>

delete/accounts/{account_id}/images/v1/{image_id}

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

Update Image -> Envelope<

Image

patch/accounts/{account_id}/images/v1/{image_id}

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

Image Details -> Envelope<

Image

get/accounts/{account_id}/images/v1/{image_id}

Fetch details for a single image.

List Images -> V4PagePagination<{ images }>

get/accounts/{account_id}/images/v1

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

Domain types

Image = { id, filename, meta, 3 more... }

Images V1

Blobs

images.v1.blobs

Methods

Base Image -> unknown

get/accounts/{account_id}/images/v1/{image_id}/blob

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.

Images V1

Keys

images.v1.keys

Methods

Delete Signing Key -> Envelope<{ keys }>

delete/accounts/{account_id}/images/v1/keys/{signing_key_name}

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

List Signing Keys -> Envelope<{ keys }>

get/accounts/{account_id}/images/v1/keys

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

Create A New Signing Key -> Envelope<{ keys }>

put/accounts/{account_id}/images/v1/keys/{signing_key_name}

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

Domain types

Key = { name, value }

Images V1

Stats

images.v1.stats

Methods

Images Usage Statistics -> Envelope<

Stat

get/accounts/{account_id}/images/v1/stats

Fetch usage statistics details for Cloudflare Images.

Domain types

Stat = { count }

Images V1

Variants

images.v1.variants

Methods

Create A Variant -> Envelope<{ variant }>

post/accounts/{account_id}/images/v1/variants

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

Delete A Variant -> Envelope<unknown | string>

delete/accounts/{account_id}/images/v1/variants/{variant_id}

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

Update A Variant -> Envelope<{ variant }>

patch/accounts/{account_id}/images/v1/variants/{variant_id}

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

Variant Details -> Envelope<{ variant }>

get/accounts/{account_id}/images/v1/variants/{variant_id}

Fetch details for a single variant.

List Variants -> Envelope<

Variant

get/accounts/{account_id}/images/v1/variants

Lists existing variants.

Domain types

Variant = { variants }

Images

V2

images.v2

Methods

List Images V2 -> Envelope<{ continuation_token, images }>

get/accounts/{account_id}/images/v2

List up to 10000 images with one request. Use the optional parameters below to get a specific range of images. Endpoint returns continuation_token if more images are present.

Images V2

Direct Uploads

images.v2.direct_uploads

Methods

Create Authenticated Direct Upload URL V2 -> Envelope<{ id, uploadURL }>

post/accounts/{account_id}/images/v2/direct_upload

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.

Security

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Images Write

path Parameters

account_id: string

(maxLength: 32)

Account identifier tag.

Body parameters

id: string

Optional

(maxLength: 1024)

Optional Image Custom ID. Up to 1024 chars. Can include any number of subpaths, and utf8 characters. Cannot start nor end with a / (forward slash). Cannot be a UUID.

expiry: string

Optional

(format: date-time)

The date after which the upload will not be accepted. Minimum: Now + 2 minutes. Maximum: Now + 6 hours.

metadata: unknown

Optional

User modifiable key-value store. Can be used for keeping references to another system of record, for managing images.

requireSignedURLs: boolean

Optional

Indicates whether the image requires a signature token to be accessed.

Response fields

errors: Array<

ResponseInfo

messages: Array<

ResponseInfo

result: { id, uploadURL }

success: true

Whether the API call was successful

Request example

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/images/v2/direct_upload \
    -H 'Content-Type: multipart/form-data' \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \
    -F id=this/is/my-customid \
    -F expiry=2021-01-02T02:20:00Z \
    -F requireSignedURLs=true

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "result": {
    "uploadURL": "https://upload.imagedelivery.net/FxUufywByo0m2v3xhKSiU8/e22e9e6b-c02b-42fd-c405-6c32af5fe600"
  },
  "success": true
}