Create authenticated direct upload URL V2

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.

Request

Path Params

account_identifier

string

required

Body Params multipart/form-data

expiry

string

optional

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

Example:

2021-01-02T02:20:00Z

string

optional

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.

Example:

this/is/my-customid

metadata

string

optional

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

requireSignedURLs

string

optional

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

Example:

true

Responses

🟢200Create authenticated direct upload URL V2 response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object

optional

Example

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

🟢200Create authenticated direct upload URL V2 response failure

Create authenticated direct upload URL V2

Request

Request samples

Responses