Create authenticated direct upload URL V2

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

Copy endpoint

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

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.

Parameters

path Path Parameters

Name	Type
`account_id` required	type ImagesAccountIdentifier = string

Request Body

multipart/form-data required

interface ImagesImageDirectUploadRequestV2 {
creator?: string;
expiry?: string;
id?: string;
metadata?: {};
requireSignedURLs?: boolean;
}

Responses

200 application/json

Create authenticated direct upload URL V2 response

type ImagesImageDirectUploadResponseV2 = type ImagesApiResponseSingle = never & { result?: { id?: string;uploadURL?: string; }; }

Client Errors

4XX application/json

Create authenticated direct upload URL V2 response failure

type ImagesImageDirectUploadResponseV2 = type ImagesApiResponseSingle = never & { result?: { id?: string;uploadURL?: string; }; } & interface ImagesApiResponseCommonFailure {
errors:

ImagesMessages

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

;
messages:

ImagesMessages

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

;
result: null;
success: false;
}