---
title: Upload asset
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/python)

[Pages](https://developers.cloudflare.com/api/python/resources/pages)

[Assets](https://developers.cloudflare.com/api/python/resources/pages/subresources/assets)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Upload asset

pages.assets.upload(AssetUploadParams\*\*kwargs)  \-> [AssetUploadResponse](https://developers.cloudflare.com/api/python/resources/pages#%28resource%29%20pages.assets%20%3E%20%28model%29%20asset%5Fupload%5Fresponse%20%3E%20%28schema%29)

POST/pages/assets/upload

Upload one or more files to the Pages asset store. Each file is identified by its content hash and is uploaded using the same JSON shape as the Cloudflare KV bulk write API. Used as part of the Pages Direct Upload workflow.

Authenticate with the JWT obtained from the upload-token endpoint: GET /accounts/{account\_id}/pages/projects/{project\_name}/upload-token

##### Security

##### ParametersExpand Collapse 

body: Iterable\[Body\]

base64: bool

Whether value is base64 encoded.

key: str

File content hash used as the object key in the Pages asset store.

metadata: BodyMetadata

content\_type: str

MIME type for the uploaded file.

value: str

File content. When base64 is true, this value is base64 encoded.

##### ReturnsExpand Collapse 

class AssetUploadResponse: …

errors: List\[Error\]

code: int

minimum1000

message: str

documentation\_url: Optional\[str\]

source: Optional\[ErrorSource\]

pointer: Optional\[str\]

messages: List\[Message\]

code: int

minimum1000

message: str

documentation\_url: Optional\[str\]

source: Optional\[MessageSource\]

pointer: Optional\[str\]

success: Literal\[true\]

Whether the API call was successful.

### Upload asset

Python

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
from cloudflare import Cloudflare

client = Cloudflare()
response = client.pages.assets.upload(
    body=[{
        "base64": True,
        "key": "b026324c6904b2a9cb4b88d6d61c81d1",
        "metadata": {
            "content_type": "text/plain"
        },
        "value": "SGVsbG8sIFdvcmxkIQ==",
    }],
)
print(response.errors)
```

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true
}
```

##### Returns Examples

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true
}
```