Skip to content
Cloudflare API
Start here
API Reference

Custom Pages

List custom pages
custom_pages.list(CustomPageListParams**kwargs) -> SyncSinglePage[CustomPageListResponse]
GET/{accounts_or_zones}/{account_or_zone_id}/custom_pages
Get a custom page
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
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]
created_on: Optional[datetime]
formatdate-time
description: Optional[str]
modified_on: Optional[datetime]
formatdate-time
preview_target: Optional[str]
required_tokens: Optional[List[str]]
state: Optional[Literal["default", "customized"]]

The custom page state.

One of the following:
"default"
"customized"
url: Optional[str]

The URL associated with the custom page.

formaturi
class CustomPageGetResponse: …
id: Optional[str]
created_on: Optional[datetime]
formatdate-time
description: Optional[str]
modified_on: Optional[datetime]
formatdate-time
preview_target: Optional[str]
required_tokens: Optional[List[str]]
state: Optional[Literal["default", "customized"]]

The custom page state.

One of the following:
"default"
"customized"
url: Optional[str]

The URL associated with the custom page.

formaturi
class CustomPageUpdateResponse: …
id: Optional[str]
created_on: Optional[datetime]
formatdate-time
description: Optional[str]
modified_on: Optional[datetime]
formatdate-time
preview_target: Optional[str]
required_tokens: Optional[List[str]]
state: Optional[Literal["default", "customized"]]

The custom page state.

One of the following:
"default"
"customized"
url: Optional[str]

The URL associated with the custom page.

formaturi