--- title: Custom Pages --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Custom Pages ##### [List custom pages](https://developers.cloudflare.com/api/python/resources/custom_pages/methods/list) custom\_pages.list(CustomPageListParams\*\*kwargs) -> SyncSinglePage\[[CustomPageListResponse]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages ##### [Get a custom page](https://developers.cloudflare.com/api/python/resources/custom_pages/methods/get) custom\_pages.get(Literal\["1000\_errors", "500\_errors", "basic\_challenge", 7 more]identifier, CustomPageGetParams\*\*kwargs) -> [CustomPageGetResponse]() GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages/{identifier} ##### [Update a custom page](https://developers.cloudflare.com/api/python/resources/custom_pages/methods/update) custom\_pages.update(Literal\["1000\_errors", "500\_errors", "basic\_challenge", 7 more]identifier, CustomPageUpdateParams\*\*kwargs) -> [CustomPageUpdateResponse]() PUT/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages/{identifier} ##### ModelsExpand Collapse
class CustomPageListResponse: … id: Optional\[str] Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property preview\_target: Optional\[str] Link to this property required\_tokens: Optional\[List\[str]] Link to this property
state: Optional\[Literal\["default", "customized"]] The custom page state. One of the following: "default" Link to this property "customized" Link to this property
Link to this property url: Optional\[str] The URL associated with the custom page. formaturi Link to this property
[Link to this property](<#(resource)%20custom_pages%20%3E%20(model)%20custom_page_list_response%20%3E%20(schema)>)
class CustomPageGetResponse: … id: Optional\[str] Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property preview\_target: Optional\[str] Link to this property required\_tokens: Optional\[List\[str]] Link to this property
state: Optional\[Literal\["default", "customized"]] The custom page state. One of the following: "default" Link to this property "customized" Link to this property
Link to this property url: Optional\[str] The URL associated with the custom page. formaturi Link to this property
[Link to this property](<#(resource)%20custom_pages%20%3E%20(model)%20custom_page_get_response%20%3E%20(schema)>)
class CustomPageUpdateResponse: … id: Optional\[str] Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property preview\_target: Optional\[str] Link to this property required\_tokens: Optional\[List\[str]] Link to this property
state: Optional\[Literal\["default", "customized"]] The custom page state. One of the following: "default" Link to this property "customized" Link to this property
Link to this property url: Optional\[str] The URL associated with the custom page. formaturi Link to this property
[Link to this property](<#(resource)%20custom_pages%20%3E%20(model)%20custom_page_update_response%20%3E%20(schema)>) #### Custom PagesAssets ##### [List custom assets](https://developers.cloudflare.com/api/python/resources/custom_pages/subresources/assets/methods/list) custom\_pages.assets.list(AssetListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[AssetListResponse]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages/assets ##### [Get a custom asset](https://developers.cloudflare.com/api/python/resources/custom_pages/subresources/assets/methods/get) custom\_pages.assets.get(strasset\_name, AssetGetParams\*\*kwargs) -> [AssetGetResponse]() GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages/assets/{asset\_name} ##### [Create a custom asset](https://developers.cloudflare.com/api/python/resources/custom_pages/subresources/assets/methods/create) custom\_pages.assets.create(AssetCreateParams\*\*kwargs) -> [AssetCreateResponse]() POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages/assets ##### [Update a custom asset](https://developers.cloudflare.com/api/python/resources/custom_pages/subresources/assets/methods/update) custom\_pages.assets.update(strasset\_name, AssetUpdateParams\*\*kwargs) -> [AssetUpdateResponse]() PUT/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages/assets/{asset\_name} ##### [Delete a custom asset](https://developers.cloudflare.com/api/python/resources/custom_pages/subresources/assets/methods/delete) custom\_pages.assets.delete(strasset\_name, AssetDeleteParams\*\*kwargs) DELETE/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_pages/assets/{asset\_name} ##### ModelsExpand Collapse
class AssetListResponse: … description: Optional\[str] A short description of the custom asset. Link to this property last\_updated: Optional\[datetime] formatdate-time Link to this property name: Optional\[str] The unique name of the custom asset. Can only contain letters (A-Z, a-z), numbers (0-9), and underscores (\_). minLength1 Link to this property size\_bytes: Optional\[int] The size of the asset content in bytes. Link to this property url: Optional\[str] The URL where the asset content is fetched from. formaturi Link to this property
[Link to this property](<#(resource)%20custom_pages.assets%20%3E%20(model)%20asset_list_response%20%3E%20(schema)>)
class AssetGetResponse: … description: Optional\[str] A short description of the custom asset. Link to this property last\_updated: Optional\[datetime] formatdate-time Link to this property name: Optional\[str] The unique name of the custom asset. Can only contain letters (A-Z, a-z), numbers (0-9), and underscores (\_). minLength1 Link to this property size\_bytes: Optional\[int] The size of the asset content in bytes. Link to this property url: Optional\[str] The URL where the asset content is fetched from. formaturi Link to this property
[Link to this property](<#(resource)%20custom_pages.assets%20%3E%20(model)%20asset_get_response%20%3E%20(schema)>)
class AssetCreateResponse: … description: Optional\[str] A short description of the custom asset. Link to this property last\_updated: Optional\[datetime] formatdate-time Link to this property name: Optional\[str] The unique name of the custom asset. Can only contain letters (A-Z, a-z), numbers (0-9), and underscores (\_). minLength1 Link to this property size\_bytes: Optional\[int] The size of the asset content in bytes. Link to this property url: Optional\[str] The URL where the asset content is fetched from. formaturi Link to this property
[Link to this property](<#(resource)%20custom_pages.assets%20%3E%20(model)%20asset_create_response%20%3E%20(schema)>)
class AssetUpdateResponse: … description: Optional\[str] A short description of the custom asset. Link to this property last\_updated: Optional\[datetime] formatdate-time Link to this property name: Optional\[str] The unique name of the custom asset. Can only contain letters (A-Z, a-z), numbers (0-9), and underscores (\_). minLength1 Link to this property size\_bytes: Optional\[int] The size of the asset content in bytes. Link to this property url: Optional\[str] The URL where the asset content is fetched from. formaturi Link to this property
[Link to this property](<#(resource)%20custom_pages.assets%20%3E%20(model)%20asset_update_response%20%3E%20(schema)>)