Upload an image

POST /accounts/{account_id}/images/v1

Copy endpoint

https://api.cloudflare.com/client/v4

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.

Parameters

path Path Parameters

Name	Type
`account_id` required	type ImagesAccountIdentifier = string

Request Body

multipart/form-data required

interface ImagesImageBasicUpload {
creator?: string;
file?: string;
id?: string;
metadata?: {};
requireSignedURLs?: boolean;
url?: string;
}

Responses

200 application/json

Upload an image response

type ImagesImageResponseSingle = type ImagesApiResponseSingle = never & { result?:

ImagesImage

interface ImagesImage {
creator?: ImagesImageCreator;
filename?: ImagesImageFilename;
id?: ImagesImageIdentifier;
meta?: ImagesImageMetadata;
requireSignedURLs?: ImagesImageRequireSignedURLs;
uploaded?: ImagesImageUploaded;
variants?: ImagesImageVariants;
}

; }

Client Errors

4XX application/json

Upload an image response failure

type ImagesImageResponseSingle = type ImagesApiResponseSingle = never & { result?:

ImagesImage

; } & interface ImagesApiResponseCommonFailure {
errors:

ImagesMessages

type ImagesMessages = { code: number;message: string; }[]

;
messages:

ImagesMessages

type ImagesMessages = { code: number;message: string; }[]

;
result: null;
success: false;
}