--- title: Projects --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Pages](https://developers.cloudflare.com/api/python/resources/pages) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Projects ##### [List Cloudflare Pages projects](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/methods/list) pages.projects.list(ProjectListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Project]()] GET/accounts/{account\_id}/pages/projects ##### [Get a Cloudflare Pages project](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/methods/get) pages.projects.get(strproject\_name, ProjectGetParams\*\*kwargs) -> [Project]() GET/accounts/{account\_id}/pages/projects/{project\_name} ##### [Get upload token](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/methods/get_upload_token) pages.projects.get\_upload\_token(strproject\_name, ProjectGetUploadTokenParams\*\*kwargs) -> [ProjectGetUploadTokenResponse]() GET/accounts/{account\_id}/pages/projects/{project\_name}/upload-token ##### [Create a Cloudflare Pages project](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/methods/create) pages.projects.create(ProjectCreateParams\*\*kwargs) -> [Project]() POST/accounts/{account\_id}/pages/projects ##### [Update a Cloudflare Pages project](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/methods/edit) pages.projects.edit(strproject\_name, ProjectEditParams\*\*kwargs) -> [Project]() PATCH/accounts/{account\_id}/pages/projects/{project\_name} ##### [Delete a Cloudflare Pages project](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/methods/delete) pages.projects.delete(strproject\_name, ProjectDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/pages/projects/{project\_name} ##### [Purge the Pages build cache](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/methods/purge_build_cache) pages.projects.purge\_build\_cache(strproject\_name, ProjectPurgeBuildCacheParams\*\*kwargs) -> object POST/accounts/{account\_id}/pages/projects/{project\_name}/purge\_build\_cache ##### ModelsExpand Collapse
class Deployment: … id: str Id of the deployment. Link to this property aliases: Optional\[List\[str]] A list of alias URLs pointing to this deployment. Link to this property
build\_config: BuildConfig Configs for the project build process. web\_analytics\_tag: Optional\[str] The classifying tag for analytics. Link to this property web\_analytics\_token: Optional\[str] The auth token for analytics. Link to this property build\_caching: Optional\[bool] Enable build caching for the project. Link to this property build\_command: Optional\[str] Command used to build project. Link to this property destination\_dir: Optional\[str] Assets output directory of the build. Link to this property root\_dir: Optional\[str] Directory to run the command. Link to this property
Link to this property created\_on: datetime When the deployment was created. formatdate-time Link to this property
deployment\_trigger: DeploymentTrigger Info about what caused the deployment.
metadata: DeploymentTriggerMetadata Additional info about the trigger. branch: str Where the trigger happened. Link to this property commit\_dirty: bool Whether the deployment trigger commit was dirty. Link to this property commit\_hash: str Hash of the deployment trigger commit. Link to this property commit\_message: str Message of the deployment trigger commit. Link to this property
Link to this property
type: Literal\["github:push", "ad\_hoc", "deploy\_hook"] What caused the deployment. One of the following: "github:push" Link to this property "ad\_hoc" Link to this property "deploy\_hook" Link to this property
Link to this property
Link to this property
env\_vars: Optional\[Dict\[str, Optional\[EnvVars]]] Environment variables used for builds and Pages Functions. One of the following:
class EnvVarsPagesPlainTextEnvVar: … A plaintext environment variable. type: Literal\["plain\_text"] Link to this property value: str Environment variable value. Link to this property
Link to this property
class EnvVarsPagesSecretTextEnvVar: … An encrypted environment variable. type: Literal\["secret\_text"] Link to this property value: str Secret value. Link to this property
Link to this property
Link to this property
environment: Literal\["preview", "production"] Type of deploy. One of the following: "preview" Link to this property "production" Link to this property
Link to this property is\_skipped: bool Whether the deployment was skipped. Link to this property latest\_stage: Stage The status of the deployment. Link to this property modified\_on: datetime When the deployment was last modified. formatdate-time Link to this property project\_id: str Id of the project. Link to this property project\_name: str Name of the Pages project. Must begin with a lowercase letter or digit and contain only lowercase letters, digits, and hyphens. Link to this property short\_id: str Short Id (8 character) of the deployment. Link to this property
source: Source Configs for the project source control.
config: SourceConfig Deprecateddeployments\_enabled: bool Use production_deployments_enabled and preview_deployment_setting for more granular control. Whether to enable automatic deployments when pushing to the source repository. When disabled, no deployments (production or preview) will be triggered automatically. Link to this property owner: str The owner of the repository. Link to this property owner\_id: str The owner ID of the repository. Link to this property path\_excludes: List\[str] A list of paths that should be excluded from triggering a preview deployment. Wildcard syntax (*) is supported. Link to this property path\_includes: List\[str] A list of paths that should be watched to trigger a preview deployment. Wildcard syntax (*) is supported. Link to this property pr\_comments\_enabled: bool Whether to enable PR comments. Link to this property preview\_branch\_excludes: List\[str] A list of branches that should not trigger a preview deployment. Wildcard syntax (*) is supported. Must be used with preview_deployment_setting set to custom. Link to this property preview\_branch\_includes: List\[str] A list of branches that should trigger a preview deployment. Wildcard syntax (*) is supported. Must be used with preview_deployment_setting set to custom. Link to this property
preview\_deployment\_setting: Literal\["all", "none", "custom"] Controls whether commits to preview branches trigger a preview deployment. One of the following: "all" Link to this property "none" Link to this property "custom" Link to this property
Link to this property production\_branch: str The production branch of the repository. Link to this property production\_deployments\_enabled: bool Whether to trigger a production deployment on commits to the production branch. Link to this property repo\_id: str The ID of the repository. Link to this property repo\_name: str The name of the repository. Link to this property
Link to this property
type: Literal\["github", "gitlab"] The source control management provider. One of the following: "github" Link to this property "gitlab" Link to this property
Link to this property
Link to this property
stages: List\[Stage] List of past stages. ended\_on: Optional\[datetime] When the stage ended. formatdate-time Link to this property
name: Literal\["queued", "initialize", "clone\_repo", 2 more] The current build stage. One of the following: "queued" Link to this property "initialize" Link to this property "clone\_repo" Link to this property "build" Link to this property "deploy" Link to this property
Link to this property started\_on: Optional\[datetime] When the stage started. formatdate-time Link to this property
status: Literal\["success", "idle", "active", 3 more] State of the current stage. One of the following: "success" Link to this property "idle" Link to this property "active" Link to this property "failure" Link to this property "canceled" Link to this property "skipped" Link to this property
Link to this property
Link to this property url: str The live URL to view this deployment. Link to this property
skip\_reason: Optional\[Literal\["commit\_message", "preview\_deployments\_disabled", "production\_deployments\_disabled", 4 more]] Why the deployment was skipped. One of the following: "commit\_message" Link to this property "preview\_deployments\_disabled" Link to this property "production\_deployments\_disabled" Link to this property "path\_config" Link to this property "branch\_config" Link to this property "pages\_to\_workers\_conversion" Link to this property "superseded\_queued\_build" Link to this property
Link to this property uses\_functions: Optional\[bool] Whether the deployment uses functions. Link to this property
[Link to this property](<#(resource)%20pages.projects%20%3E%20(model)%20deployment%20%3E%20(schema)>)
class Project: … id: str ID of the project. Link to this property canonical\_deployment: Optional\[Deployment] Most recent production deployment of the project. Link to this property created\_on: datetime When the project was created. formatdate-time Link to this property
deployment\_configs: DeploymentConfigs Configs for deployments in a project.
preview: DeploymentConfigsPreview Configs for preview deploys. always\_use\_latest\_compatibility\_date: bool Whether to always use the latest compatibility date for Pages Functions. Link to this property build\_image\_major\_version: int The major version of the build image to use for Pages Functions. Link to this property compatibility\_date: str Compatibility date used for Pages Functions. Link to this property compatibility\_flags: List\[str] Compatibility flags used for Pages Functions. Link to this property
env\_vars: Optional\[Dict\[str, Optional\[DeploymentConfigsPreviewEnvVars]]] Environment variables used for builds and Pages Functions. One of the following:
class DeploymentConfigsPreviewEnvVarsPagesPlainTextEnvVar: … A plaintext environment variable. type: Literal\["plain\_text"] Link to this property value: str Environment variable value. Link to this property
Link to this property
class DeploymentConfigsPreviewEnvVarsPagesSecretTextEnvVar: … An encrypted environment variable. type: Literal\["secret\_text"] Link to this property value: str Secret value. Link to this property
Link to this property
Link to this property fail\_open: bool Whether to fail open when the deployment config cannot be applied. Link to this property
Deprecatedusage\_model: Literal\["standard", "bundled", "unbound"] All new projects now use the Standard usage model. The usage model for Pages Functions. One of the following: "standard" Link to this property "bundled" Link to this property "unbound" Link to this property
Link to this property
ai\_bindings: Optional\[Dict\[str, DeploymentConfigsPreviewAIBindings]] Constellation bindings used for Pages Functions. project\_id: str Link to this property
Link to this property
analytics\_engine\_datasets: Optional\[Dict\[str, DeploymentConfigsPreviewAnalyticsEngineDatasets]] Analytics Engine bindings used for Pages Functions. dataset: str Name of the dataset. Link to this property
Link to this property browsers: Optional\[Dict\[str, Optional\[DeploymentConfigsPreviewBrowsers]]] Browser bindings used for Pages Functions. Link to this property
d1\_databases: Optional\[Dict\[str, DeploymentConfigsPreviewD1Databases]] D1 databases used for Pages Functions. id: str UUID of the D1 database. Link to this property
Link to this property
durable\_object\_namespaces: Optional\[Dict\[str, DeploymentConfigsPreviewDurableObjectNamespaces]] Durable Object namespaces used for Pages Functions. namespace\_id: str ID of the Durable Object namespace. Link to this property
Link to this property
hyperdrive\_bindings: Optional\[Dict\[str, DeploymentConfigsPreviewHyperdriveBindings]] Hyperdrive bindings used for Pages Functions. id: str Link to this property
Link to this property
kv\_namespaces: Optional\[Dict\[str, DeploymentConfigsPreviewKVNamespaces]] KV namespaces used for Pages Functions. namespace\_id: str ID of the KV namespace. Link to this property
Link to this property
limits: Optional\[DeploymentConfigsPreviewLimits] Limits for Pages Functions. cpu\_ms: int CPU time limit in milliseconds. Link to this property
Link to this property
mtls\_certificates: Optional\[Dict\[str, DeploymentConfigsPreviewMTLSCertificates]] mTLS bindings used for Pages Functions. certificate\_id: str Link to this property
Link to this property
placement: Optional\[DeploymentConfigsPreviewPlacement] Placement setting used for Pages Functions. mode: str Placement mode. Link to this property
Link to this property
queue\_producers: Optional\[Dict\[str, DeploymentConfigsPreviewQueueProducers]] Queue Producer bindings used for Pages Functions. name: str Name of the Queue. Link to this property
Link to this property
r2\_buckets: Optional\[Dict\[str, DeploymentConfigsPreviewR2Buckets]] R2 buckets used for Pages Functions. name: str Name of the R2 bucket. Link to this property jurisdiction: Optional\[str] Jurisdiction of the R2 bucket. Link to this property
Link to this property
services: Optional\[Dict\[str, DeploymentConfigsPreviewServices]] Services used for Pages Functions. environment: str The Service environment. Link to this property service: str The Service name. Link to this property entrypoint: Optional\[str] The entrypoint to bind to. Link to this property
Link to this property
vectorize\_bindings: Optional\[Dict\[str, DeploymentConfigsPreviewVectorizeBindings]] Vectorize bindings used for Pages Functions. index\_name: str Link to this property
Link to this property wrangler\_config\_hash: Optional\[str] Hash of the Wrangler configuration used for the deployment. Link to this property
Link to this property
production: DeploymentConfigsProduction Configs for production deploys. always\_use\_latest\_compatibility\_date: bool Whether to always use the latest compatibility date for Pages Functions. Link to this property build\_image\_major\_version: int The major version of the build image to use for Pages Functions. Link to this property compatibility\_date: str Compatibility date used for Pages Functions. Link to this property compatibility\_flags: List\[str] Compatibility flags used for Pages Functions. Link to this property
env\_vars: Optional\[Dict\[str, Optional\[DeploymentConfigsProductionEnvVars]]] Environment variables used for builds and Pages Functions. One of the following:
class DeploymentConfigsProductionEnvVarsPagesPlainTextEnvVar: … A plaintext environment variable. type: Literal\["plain\_text"] Link to this property value: str Environment variable value. Link to this property
Link to this property
class DeploymentConfigsProductionEnvVarsPagesSecretTextEnvVar: … An encrypted environment variable. type: Literal\["secret\_text"] Link to this property value: str Secret value. Link to this property
Link to this property
Link to this property fail\_open: bool Whether to fail open when the deployment config cannot be applied. Link to this property
Deprecatedusage\_model: Literal\["standard", "bundled", "unbound"] All new projects now use the Standard usage model. The usage model for Pages Functions. One of the following: "standard" Link to this property "bundled" Link to this property "unbound" Link to this property
Link to this property
ai\_bindings: Optional\[Dict\[str, DeploymentConfigsProductionAIBindings]] Constellation bindings used for Pages Functions. project\_id: str Link to this property
Link to this property
analytics\_engine\_datasets: Optional\[Dict\[str, DeploymentConfigsProductionAnalyticsEngineDatasets]] Analytics Engine bindings used for Pages Functions. dataset: str Name of the dataset. Link to this property
Link to this property browsers: Optional\[Dict\[str, Optional\[DeploymentConfigsProductionBrowsers]]] Browser bindings used for Pages Functions. Link to this property
d1\_databases: Optional\[Dict\[str, DeploymentConfigsProductionD1Databases]] D1 databases used for Pages Functions. id: str UUID of the D1 database. Link to this property
Link to this property
durable\_object\_namespaces: Optional\[Dict\[str, DeploymentConfigsProductionDurableObjectNamespaces]] Durable Object namespaces used for Pages Functions. namespace\_id: str ID of the Durable Object namespace. Link to this property
Link to this property
hyperdrive\_bindings: Optional\[Dict\[str, DeploymentConfigsProductionHyperdriveBindings]] Hyperdrive bindings used for Pages Functions. id: str Link to this property
Link to this property
kv\_namespaces: Optional\[Dict\[str, DeploymentConfigsProductionKVNamespaces]] KV namespaces used for Pages Functions. namespace\_id: str ID of the KV namespace. Link to this property
Link to this property
limits: Optional\[DeploymentConfigsProductionLimits] Limits for Pages Functions. cpu\_ms: int CPU time limit in milliseconds. Link to this property
Link to this property
mtls\_certificates: Optional\[Dict\[str, DeploymentConfigsProductionMTLSCertificates]] mTLS bindings used for Pages Functions. certificate\_id: str Link to this property
Link to this property
placement: Optional\[DeploymentConfigsProductionPlacement] Placement setting used for Pages Functions. mode: str Placement mode. Link to this property
Link to this property
queue\_producers: Optional\[Dict\[str, DeploymentConfigsProductionQueueProducers]] Queue Producer bindings used for Pages Functions. name: str Name of the Queue. Link to this property
Link to this property
r2\_buckets: Optional\[Dict\[str, DeploymentConfigsProductionR2Buckets]] R2 buckets used for Pages Functions. name: str Name of the R2 bucket. Link to this property jurisdiction: Optional\[str] Jurisdiction of the R2 bucket. Link to this property
Link to this property
services: Optional\[Dict\[str, DeploymentConfigsProductionServices]] Services used for Pages Functions. environment: str The Service environment. Link to this property service: str The Service name. Link to this property entrypoint: Optional\[str] The entrypoint to bind to. Link to this property
Link to this property
vectorize\_bindings: Optional\[Dict\[str, DeploymentConfigsProductionVectorizeBindings]] Vectorize bindings used for Pages Functions. index\_name: str Link to this property
Link to this property wrangler\_config\_hash: Optional\[str] Hash of the Wrangler configuration used for the deployment. Link to this property
Link to this property
Link to this property framework: str Framework the project is using. Link to this property framework\_version: str Version of the framework the project is using. Link to this property latest\_deployment: Optional\[Deployment] Most recent deployment of the project. Link to this property name: str Name of the Pages project. Must begin with a lowercase letter or digit and contain only lowercase letters, digits, and hyphens. Link to this property preview\_script\_name: str Name of the preview script. Link to this property production\_branch: str Production branch of the project. Used to identify production deployments. Link to this property production\_script\_name: str Name of the production script. Link to this property uses\_functions: Optional\[bool] Whether the project uses functions. Link to this property
build\_config: Optional\[BuildConfig] Configs for the project build process. web\_analytics\_tag: Optional\[str] The classifying tag for analytics. Link to this property web\_analytics\_token: Optional\[str] The auth token for analytics. Link to this property build\_caching: Optional\[bool] Enable build caching for the project. Link to this property build\_command: Optional\[str] Command used to build project. Link to this property destination\_dir: Optional\[str] Assets output directory of the build. Link to this property root\_dir: Optional\[str] Directory to run the command. Link to this property
Link to this property domains: Optional\[List\[str]] A list of associated custom domains for the project. Link to this property
source: Optional\[Source] Configs for the project source control.
config: SourceConfig Deprecateddeployments\_enabled: bool Use production_deployments_enabled and preview_deployment_setting for more granular control. Whether to enable automatic deployments when pushing to the source repository. When disabled, no deployments (production or preview) will be triggered automatically. Link to this property owner: str The owner of the repository. Link to this property owner\_id: str The owner ID of the repository. Link to this property path\_excludes: List\[str] A list of paths that should be excluded from triggering a preview deployment. Wildcard syntax (*) is supported. Link to this property path\_includes: List\[str] A list of paths that should be watched to trigger a preview deployment. Wildcard syntax (*) is supported. Link to this property pr\_comments\_enabled: bool Whether to enable PR comments. Link to this property preview\_branch\_excludes: List\[str] A list of branches that should not trigger a preview deployment. Wildcard syntax (*) is supported. Must be used with preview_deployment_setting set to custom. Link to this property preview\_branch\_includes: List\[str] A list of branches that should trigger a preview deployment. Wildcard syntax (*) is supported. Must be used with preview_deployment_setting set to custom. Link to this property
preview\_deployment\_setting: Literal\["all", "none", "custom"] Controls whether commits to preview branches trigger a preview deployment. One of the following: "all" Link to this property "none" Link to this property "custom" Link to this property
Link to this property production\_branch: str The production branch of the repository. Link to this property production\_deployments\_enabled: bool Whether to trigger a production deployment on commits to the production branch. Link to this property repo\_id: str The ID of the repository. Link to this property repo\_name: str The name of the repository. Link to this property
Link to this property
type: Literal\["github", "gitlab"] The source control management provider. One of the following: "github" Link to this property "gitlab" Link to this property
Link to this property
Link to this property subdomain: Optional\[str] The Cloudflare subdomain associated with the project. Link to this property
[Link to this property](<#(resource)%20pages.projects%20%3E%20(model)%20project%20%3E%20(schema)>)
class Stage: … The status of the deployment. ended\_on: Optional\[datetime] When the stage ended. formatdate-time Link to this property
name: Literal\["queued", "initialize", "clone\_repo", 2 more] The current build stage. One of the following: "queued" Link to this property "initialize" Link to this property "clone\_repo" Link to this property "build" Link to this property "deploy" Link to this property
Link to this property started\_on: Optional\[datetime] When the stage started. formatdate-time Link to this property
status: Literal\["success", "idle", "active", 3 more] State of the current stage. One of the following: "success" Link to this property "idle" Link to this property "active" Link to this property "failure" Link to this property "canceled" Link to this property "skipped" Link to this property
Link to this property
[Link to this property](<#(resource)%20pages.projects%20%3E%20(model)%20stage%20%3E%20(schema)>)
class ProjectGetUploadTokenResponse: … jwt: str Short-lived JWT used to authenticate Pages Direct Upload asset operations. Link to this property
[Link to this property](<#(resource)%20pages.projects%20%3E%20(model)%20project_get_upload_token_response%20%3E%20(schema)>) #### ProjectsDeployments ##### [List Pages deployments](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/methods/list) pages.projects.deployments.list(strproject\_name, DeploymentListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Deployment]()] GET/accounts/{account\_id}/pages/projects/{project\_name}/deployments ##### [Get a Pages deployment](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/methods/get) pages.projects.deployments.get(strdeployment\_id, DeploymentGetParams\*\*kwargs) -> [Deployment]() GET/accounts/{account\_id}/pages/projects/{project\_name}/deployments/{deployment\_id} ##### [Create a Pages deployment](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/methods/create) pages.projects.deployments.create(strproject\_name, DeploymentCreateParams\*\*kwargs) -> [Deployment]() POST/accounts/{account\_id}/pages/projects/{project\_name}/deployments ##### [Delete a Pages deployment](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/methods/delete) pages.projects.deployments.delete(strdeployment\_id, DeploymentDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/pages/projects/{project\_name}/deployments/{deployment\_id} ##### [Retry a Pages deployment](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/methods/retry) pages.projects.deployments.retry(strdeployment\_id, DeploymentRetryParams\*\*kwargs) -> [Deployment]() POST/accounts/{account\_id}/pages/projects/{project\_name}/deployments/{deployment\_id}/retry ##### [Roll back a Pages deployment](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/methods/rollback) pages.projects.deployments.rollback(strdeployment\_id, DeploymentRollbackParams\*\*kwargs) -> [Deployment]() POST/accounts/{account\_id}/pages/projects/{project\_name}/deployments/{deployment\_id}/rollback #### ProjectsDeploymentsHistory #### ProjectsDeploymentsHistoryLogs ##### [Get Pages deployment logs](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/subresources/history/subresources/logs/methods/get) pages.projects.deployments.history.logs.get(strdeployment\_id, LogGetParams\*\*kwargs) -> [LogGetResponse]() GET/accounts/{account\_id}/pages/projects/{project\_name}/deployments/{deployment\_id}/history/logs ##### ModelsExpand Collapse
class LogGetResponse: …
data: List\[Data] line: str Link to this property ts: str Link to this property
Link to this property includes\_container\_logs: bool Link to this property total: int Link to this property
[Link to this property](<#(resource)%20pages.projects.deployments.history.logs%20%3E%20(model)%20log_get_response%20%3E%20(schema)>) #### ProjectsDeploymentsTails ##### [Create deployment tail](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/subresources/tails/methods/create) pages.projects.deployments.tails.create(strdeployment\_id, TailCreateParams\*\*kwargs) -> [TailCreateResponse]() POST/accounts/{account\_id}/pages/projects/{project\_name}/deployments/{deployment\_id}/tails ##### [Delete deployment tail](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/deployments/subresources/tails/methods/delete) pages.projects.deployments.tails.delete(strtail\_id, TailDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/pages/projects/{project\_name}/deployments/{deployment\_id}/tails/{tail\_id} ##### ModelsExpand Collapse
class TailCreateResponse: … A tail session for streaming logs from a Pages deployment. id: str Identifier of the tail session. Link to this property url: Optional\[str] Optional WebSocket URL to connect to for receiving tail events, when returned by the tail service. Link to this property
[Link to this property](<#(resource)%20pages.projects.deployments.tails%20%3E%20(model)%20tail_create_response%20%3E%20(schema)>) #### ProjectsDomains ##### [List Pages custom domains](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/domains/methods/list) pages.projects.domains.list(strproject\_name, DomainListParams\*\*kwargs) -> SyncSinglePage\[[DomainListResponse]()] GET/accounts/{account\_id}/pages/projects/{project\_name}/domains ##### [Get a Pages custom domain](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/domains/methods/get) pages.projects.domains.get(strdomain\_name, DomainGetParams\*\*kwargs) -> [DomainGetResponse]() GET/accounts/{account\_id}/pages/projects/{project\_name}/domains/{domain\_name} ##### [Add a Pages custom domain](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/domains/methods/create) pages.projects.domains.create(strproject\_name, DomainCreateParams\*\*kwargs) -> [DomainCreateResponse]() POST/accounts/{account\_id}/pages/projects/{project\_name}/domains ##### [Retry custom domain validation](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/domains/methods/edit) pages.projects.domains.edit(strdomain\_name, DomainEditParams\*\*kwargs) -> [DomainEditResponse]() PATCH/accounts/{account\_id}/pages/projects/{project\_name}/domains/{domain\_name} ##### [Delete a Pages custom domain](https://developers.cloudflare.com/api/python/resources/pages/subresources/projects/subresources/domains/methods/delete) pages.projects.domains.delete(strdomain\_name, DomainDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/pages/projects/{project\_name}/domains/{domain\_name} ##### ModelsExpand Collapse
class DomainListResponse: … id: str Link to this property
certificate\_authority: Literal\["google", "lets\_encrypt"] One of the following: "google" Link to this property "lets\_encrypt" Link to this property
Link to this property created\_on: str Link to this property domain\_id: str Link to this property name: str Fully qualified domain name for the Pages project, such as example.com. Link to this property
status: Literal\["initializing", "pending", "active", 3 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property
validation\_data: ValidationData
method: Literal\["http", "txt"] One of the following: "http" Link to this property "txt" Link to this property
Link to this property
status: Literal\["initializing", "pending", "active", 2 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property txt\_name: Optional\[str] Link to this property txt\_value: Optional\[str] Link to this property
Link to this property
verification\_data: VerificationData
status: Literal\["pending", "active", "deactivated", 2 more] One of the following: "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property
Link to this property zone\_tag: str Link to this property
[Link to this property](<#(resource)%20pages.projects.domains%20%3E%20(model)%20domain_list_response%20%3E%20(schema)>)
class DomainGetResponse: … id: str Link to this property
certificate\_authority: Literal\["google", "lets\_encrypt"] One of the following: "google" Link to this property "lets\_encrypt" Link to this property
Link to this property created\_on: str Link to this property domain\_id: str Link to this property name: str Fully qualified domain name for the Pages project, such as example.com. Link to this property
status: Literal\["initializing", "pending", "active", 3 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property
validation\_data: ValidationData
method: Literal\["http", "txt"] One of the following: "http" Link to this property "txt" Link to this property
Link to this property
status: Literal\["initializing", "pending", "active", 2 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property txt\_name: Optional\[str] Link to this property txt\_value: Optional\[str] Link to this property
Link to this property
verification\_data: VerificationData
status: Literal\["pending", "active", "deactivated", 2 more] One of the following: "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property
Link to this property zone\_tag: str Link to this property
[Link to this property](<#(resource)%20pages.projects.domains%20%3E%20(model)%20domain_get_response%20%3E%20(schema)>)
class DomainCreateResponse: … id: str Link to this property
certificate\_authority: Literal\["google", "lets\_encrypt"] One of the following: "google" Link to this property "lets\_encrypt" Link to this property
Link to this property created\_on: str Link to this property domain\_id: str Link to this property name: str Fully qualified domain name for the Pages project, such as example.com. Link to this property
status: Literal\["initializing", "pending", "active", 3 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property
validation\_data: ValidationData
method: Literal\["http", "txt"] One of the following: "http" Link to this property "txt" Link to this property
Link to this property
status: Literal\["initializing", "pending", "active", 2 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property txt\_name: Optional\[str] Link to this property txt\_value: Optional\[str] Link to this property
Link to this property
verification\_data: VerificationData
status: Literal\["pending", "active", "deactivated", 2 more] One of the following: "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property
Link to this property zone\_tag: str Link to this property
[Link to this property](<#(resource)%20pages.projects.domains%20%3E%20(model)%20domain_create_response%20%3E%20(schema)>)
class DomainEditResponse: … id: str Link to this property
certificate\_authority: Literal\["google", "lets\_encrypt"] One of the following: "google" Link to this property "lets\_encrypt" Link to this property
Link to this property created\_on: str Link to this property domain\_id: str Link to this property name: str Fully qualified domain name for the Pages project, such as example.com. Link to this property
status: Literal\["initializing", "pending", "active", 3 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property
validation\_data: ValidationData
method: Literal\["http", "txt"] One of the following: "http" Link to this property "txt" Link to this property
Link to this property
status: Literal\["initializing", "pending", "active", 2 more] One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "deactivated" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property txt\_name: Optional\[str] Link to this property txt\_value: Optional\[str] Link to this property
Link to this property
verification\_data: VerificationData
status: Literal\["pending", "active", "deactivated", 2 more] One of the following: "pending" Link to this property "active" Link to this property "deactivated" Link to this property "blocked" Link to this property "error" Link to this property
Link to this property error\_message: Optional\[str] Link to this property
Link to this property zone\_tag: str Link to this property
[Link to this property](<#(resource)%20pages.projects.domains%20%3E%20(model)%20domain_edit_response%20%3E%20(schema)>)