--- title: Upload asset --- [Skip to content](#_top) [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]() 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. Link to this property key: str File content hash used as the object key in the Pages asset store. Link to this property
metadata: BodyMetadata content\_type: str MIME type for the uploaded file. Link to this property
Link to this property value: str File content. When base64 is true, this value is base64 encoded. Link to this property
[Link to this property](<#(resource)%20pages.assets%20%3E%20(method)%20upload%20%3E%20(params)%20default%20%3E%20(param)%20body%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class AssetUploadResponse: …
errors: List\[Error] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[ErrorSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property
messages: List\[Message] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[MessageSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property success: Literal\[true] Whether the API call was successful. Link to this property
[Link to this property](<#(resource)%20pages.assets%20%3E%20(model)%20asset_upload_response%20%3E%20(schema)>) ### Upload asset Python HTTPTypeScriptPythonGoTerraform ``` 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 } ```