Upload an image via URL

POST

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/images/v1

Last modified:2022-12-16 13:48:32

Upload an image via URL with up to 10 Megabytes using a single HTTP POST (multipart/form-data) request.

Request

Path Params

account_identifier

string

required

Body Params multipart/form-data

metadata

string

optional

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

requireSignedURLs

string

optional

Indicates whether the image requires a signature token for the access.

Example:

true

url

string

required

A URL to fetch an image from origin.

Example:

https://example.com/path/to/logo.png

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//images/v1' \
--form 'url="https://example.com/path/to/logo.png"'

Responses

🟢200Upload an image via URL 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": {},
    "success": true
}

🟢200Upload an image via URL response failure

Modified at 2022-12-16 13:48:32

List images

Images usage statistics