Get R2 Upload Presigned URL

Call this API to obtain a presigned URL

Use the received uploadUrl to upload the file via an HTTP PUT request

After successful upload, the file will be stored in the specified R2 bucket at the path indicated by data.key

Notes

This API consumes 1 coin from the user's balance

The presigned URL is valid for 300 seconds by default; a new URL must be requested after expiration

Uploaded files are stored in the user's dedicated directory: environment/userId/storage/filename

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "code": 0,
    "data": {
        "uploadUrl": "https://a2e-prod-jumpy.249f5378ffb8a0786e403d44c62e5459.r2.cloudflarestorage.com/beta/1avdcdd7bcf6ab778bad1234/storage/path/test.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=774ea6b5cfe6a35a7bfa721eee24b0a5%2F20250801%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250801T092045Z&X-Amz-Expires=300&X-Amz-Signature=2e5ee8be0b46a42c58f67eb8ff70f3b8e99e75466860cb8e9511f3f718bcc45f&X-Amz-SignedHeaders=host&x-amz-checksum-crc32=AAAAAA%3D%3D&x-amz-sdk-checksum-algorithm=CRC32&x-id=PutObject",
        "key": "beta/665da3d7bcf6ab778bad0f6a/storage/test.mp4",
        "bucket": "a2e-prod-jumpy",
        "expiresIn": 300
    },
    "trace_id": "14992ffe-68b3-44ef-973e-c72c1fe7c34c"
}

Get R2 Upload Presigned URL

Notes#

Request

Request samples

Responses

Notes