Update image

PATCH

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

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

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

Request

Path Params

identifier

string

required

account_identifier

string

required

Body Params application/json

metadata

object

optional

User modifiable key-value store. Can be used for keeping references to another system of record for managing images. No change if not specified.

requireSignedURLs

boolean

optional

Indicates whether the image can be accessed using only its UID. If set to true, a signed token needs to be generated with a signing key to view the image. Returns a new UID on a change. No change if not specified.

Example:

true

Example

{
    "metadata": {},
    "requireSignedURLs": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://api.cloudflare.com/client/v4/accounts//images/v1/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "metadata": {},
    "requireSignedURLs": true
}'

Responses

🟢200Update image 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
}

🟢200Update image response failure

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

Image details

Base image