## Get project `client.pages.projects.get(stringprojectName, ProjectGetParamsparams, RequestOptionsoptions?): Project` **get** `/accounts/{account_id}/pages/projects/{project_name}` Fetch a project by name. ### Parameters - `projectName: string` Name of the project. - `params: ProjectGetParams` - `account_id: string` Identifier. ### Returns - `Project` - `id: string` ID of the project. - `canonical_deployment: Deployment | null` Most recent production deployment of the project. - `id: string` Id of the deployment. - `aliases: Array | null` A list of alias URLs pointing to this deployment. - `build_config: BuildConfig` Configs for the project build process. - `web_analytics_tag: string | null` The classifying tag for analytics. - `web_analytics_token: string | null` The auth token for analytics. - `build_caching?: boolean | null` Enable build caching for the project. - `build_command?: string | null` Command used to build project. - `destination_dir?: string | null` Assets output directory of the build. - `root_dir?: string | null` Directory to run the command. - `created_on: string` When the deployment was created. - `deployment_trigger: DeploymentTrigger` Info about what caused the deployment. - `metadata: Metadata` Additional info about the trigger. - `branch: string` Where the trigger happened. - `commit_dirty: boolean` Whether the deployment trigger commit was dirty. - `commit_hash: string` Hash of the deployment trigger commit. - `commit_message: string` Message of the deployment trigger commit. - `type: "github:push" | "ad_hoc" | "deploy_hook"` What caused the deployment. - `"github:push"` - `"ad_hoc"` - `"deploy_hook"` - `env_vars: Record | null` Environment variables used for builds and Pages Functions. - `PagesPlainTextEnvVar` A plaintext environment variable. - `type: "plain_text"` - `"plain_text"` - `value: string` Environment variable value. - `PagesSecretTextEnvVar` An encrypted environment variable. - `type: "secret_text"` - `"secret_text"` - `value: string` Secret value. - `environment: "preview" | "production"` Type of deploy. - `"preview"` - `"production"` - `is_skipped: boolean` If the deployment has been skipped. - `latest_stage: Stage` The status of the deployment. - `ended_on: string | null` When the stage ended. - `name: "queued" | "initialize" | "clone_repo" | 2 more` The current build stage. - `"queued"` - `"initialize"` - `"clone_repo"` - `"build"` - `"deploy"` - `started_on: string | null` When the stage started. - `status: "success" | "idle" | "active" | 2 more` State of the current stage. - `"success"` - `"idle"` - `"active"` - `"failure"` - `"canceled"` - `modified_on: string` When the deployment was last modified. - `project_id: string` Id of the project. - `project_name: string` Name of the project. - `short_id: string` Short Id (8 character) of the deployment. - `source: Source` Configs for the project source control. - `config: Config` - `deployments_enabled: boolean` Whether to enable automatic deployments when pushing to the source repository. When disabled, no deployments (production or preview) will be triggered automatically. - `owner: string` The owner of the repository. - `owner_id: string` The owner ID of the repository. - `path_excludes: Array` A list of paths that should be excluded from triggering a preview deployment. Wildcard syntax (`*`) is supported. - `path_includes: Array` A list of paths that should be watched to trigger a preview deployment. Wildcard syntax (`*`) is supported. - `pr_comments_enabled: boolean` Whether to enable PR comments. - `preview_branch_excludes: Array` 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`. - `preview_branch_includes: Array` A list of branches that should trigger a preview deployment. Wildcard syntax (`*`) is supported. Must be used with `preview_deployment_setting` set to `custom`. - `preview_deployment_setting: "all" | "none" | "custom"` Controls whether commits to preview branches trigger a preview deployment. - `"all"` - `"none"` - `"custom"` - `production_branch: string` The production branch of the repository. - `production_deployments_enabled: boolean` Whether to trigger a production deployment on commits to the production branch. - `repo_id: string` The ID of the repository. - `repo_name: string` The name of the repository. - `type: "github" | "gitlab"` The source control management provider. - `"github"` - `"gitlab"` - `stages: Array` List of past stages. - `ended_on: string | null` When the stage ended. - `name: "queued" | "initialize" | "clone_repo" | 2 more` The current build stage. - `started_on: string | null` When the stage started. - `status: "success" | "idle" | "active" | 2 more` State of the current stage. - `url: string` The live URL to view this deployment. - `uses_functions?: boolean | null` Whether the deployment uses functions. - `created_on: string` When the project was created. - `deployment_configs: DeploymentConfigs` Configs for deployments in a project. - `preview: Preview` Configs for preview deploys. - `always_use_latest_compatibility_date: boolean` Whether to always use the latest compatibility date for Pages Functions. - `build_image_major_version: number` The major version of the build image to use for Pages Functions. - `compatibility_date: string` Compatibility date used for Pages Functions. - `compatibility_flags: Array` Compatibility flags used for Pages Functions. - `env_vars: Record | null` Environment variables used for builds and Pages Functions. - `PagesPlainTextEnvVar` A plaintext environment variable. - `type: "plain_text"` - `"plain_text"` - `value: string` Environment variable value. - `PagesSecretTextEnvVar` An encrypted environment variable. - `type: "secret_text"` - `"secret_text"` - `value: string` Secret value. - `fail_open: boolean` Whether to fail open when the deployment config cannot be applied. - `usage_model: "standard" | "bundled" | "unbound"` The usage model for Pages Functions. - `"standard"` - `"bundled"` - `"unbound"` - `ai_bindings?: Record` Constellation bindings used for Pages Functions. - `project_id: string` - `analytics_engine_datasets?: Record` Analytics Engine bindings used for Pages Functions. - `dataset: string` Name of the dataset. - `browsers?: Record` Browser bindings used for Pages Functions. - `d1_databases?: Record` D1 databases used for Pages Functions. - `id: string` UUID of the D1 database. - `durable_object_namespaces?: Record` Durable Object namespaces used for Pages Functions. - `namespace_id: string` ID of the Durable Object namespace. - `hyperdrive_bindings?: Record` Hyperdrive bindings used for Pages Functions. - `id: string` - `kv_namespaces?: Record` KV namespaces used for Pages Functions. - `namespace_id: string` ID of the KV namespace. - `limits?: Limits` Limits for Pages Functions. - `cpu_ms: number` CPU time limit in milliseconds. - `mtls_certificates?: Record` mTLS bindings used for Pages Functions. - `certificate_id: string` - `placement?: Placement` Placement setting used for Pages Functions. - `mode: string` Placement mode. - `queue_producers?: Record` Queue Producer bindings used for Pages Functions. - `name: string` Name of the Queue. - `r2_buckets?: Record` R2 buckets used for Pages Functions. - `name: string` Name of the R2 bucket. - `jurisdiction?: string | null` Jurisdiction of the R2 bucket. - `services?: Record` Services used for Pages Functions. - `environment: string` The Service environment. - `service: string` The Service name. - `entrypoint?: string | null` The entrypoint to bind to. - `vectorize_bindings?: Record` Vectorize bindings used for Pages Functions. - `index_name: string` - `wrangler_config_hash?: string` Hash of the Wrangler configuration used for the deployment. - `production: Production` Configs for production deploys. - `always_use_latest_compatibility_date: boolean` Whether to always use the latest compatibility date for Pages Functions. - `build_image_major_version: number` The major version of the build image to use for Pages Functions. - `compatibility_date: string` Compatibility date used for Pages Functions. - `compatibility_flags: Array` Compatibility flags used for Pages Functions. - `env_vars: Record | null` Environment variables used for builds and Pages Functions. - `PagesPlainTextEnvVar` A plaintext environment variable. - `type: "plain_text"` - `"plain_text"` - `value: string` Environment variable value. - `PagesSecretTextEnvVar` An encrypted environment variable. - `type: "secret_text"` - `"secret_text"` - `value: string` Secret value. - `fail_open: boolean` Whether to fail open when the deployment config cannot be applied. - `usage_model: "standard" | "bundled" | "unbound"` The usage model for Pages Functions. - `"standard"` - `"bundled"` - `"unbound"` - `ai_bindings?: Record` Constellation bindings used for Pages Functions. - `project_id: string` - `analytics_engine_datasets?: Record` Analytics Engine bindings used for Pages Functions. - `dataset: string` Name of the dataset. - `browsers?: Record` Browser bindings used for Pages Functions. - `d1_databases?: Record` D1 databases used for Pages Functions. - `id: string` UUID of the D1 database. - `durable_object_namespaces?: Record` Durable Object namespaces used for Pages Functions. - `namespace_id: string` ID of the Durable Object namespace. - `hyperdrive_bindings?: Record` Hyperdrive bindings used for Pages Functions. - `id: string` - `kv_namespaces?: Record` KV namespaces used for Pages Functions. - `namespace_id: string` ID of the KV namespace. - `limits?: Limits` Limits for Pages Functions. - `cpu_ms: number` CPU time limit in milliseconds. - `mtls_certificates?: Record` mTLS bindings used for Pages Functions. - `certificate_id: string` - `placement?: Placement` Placement setting used for Pages Functions. - `mode: string` Placement mode. - `queue_producers?: Record` Queue Producer bindings used for Pages Functions. - `name: string` Name of the Queue. - `r2_buckets?: Record` R2 buckets used for Pages Functions. - `name: string` Name of the R2 bucket. - `jurisdiction?: string | null` Jurisdiction of the R2 bucket. - `services?: Record` Services used for Pages Functions. - `environment: string` The Service environment. - `service: string` The Service name. - `entrypoint?: string | null` The entrypoint to bind to. - `vectorize_bindings?: Record` Vectorize bindings used for Pages Functions. - `index_name: string` - `wrangler_config_hash?: string` Hash of the Wrangler configuration used for the deployment. - `framework: string` Framework the project is using. - `framework_version: string` Version of the framework the project is using. - `latest_deployment: Deployment | null` Most recent deployment of the project. - `name: string` Name of the project. - `preview_script_name: string` Name of the preview script. - `production_branch: string` Production branch of the project. Used to identify production deployments. - `production_script_name: string` Name of the production script. - `uses_functions: boolean | null` Whether the project uses functions. - `build_config?: BuildConfig` Configs for the project build process. - `web_analytics_tag: string | null` The classifying tag for analytics. - `web_analytics_token: string | null` The auth token for analytics. - `build_caching?: boolean | null` Enable build caching for the project. - `build_command?: string | null` Command used to build project. - `destination_dir?: string | null` Assets output directory of the build. - `root_dir?: string | null` Directory to run the command. - `domains?: Array` A list of associated custom domains for the project. - `source?: Source` Configs for the project source control. - `config: Config` - `deployments_enabled: boolean` Whether to enable automatic deployments when pushing to the source repository. When disabled, no deployments (production or preview) will be triggered automatically. - `owner: string` The owner of the repository. - `owner_id: string` The owner ID of the repository. - `path_excludes: Array` A list of paths that should be excluded from triggering a preview deployment. Wildcard syntax (`*`) is supported. - `path_includes: Array` A list of paths that should be watched to trigger a preview deployment. Wildcard syntax (`*`) is supported. - `pr_comments_enabled: boolean` Whether to enable PR comments. - `preview_branch_excludes: Array` 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`. - `preview_branch_includes: Array` A list of branches that should trigger a preview deployment. Wildcard syntax (`*`) is supported. Must be used with `preview_deployment_setting` set to `custom`. - `preview_deployment_setting: "all" | "none" | "custom"` Controls whether commits to preview branches trigger a preview deployment. - `"all"` - `"none"` - `"custom"` - `production_branch: string` The production branch of the repository. - `production_deployments_enabled: boolean` Whether to trigger a production deployment on commits to the production branch. - `repo_id: string` The ID of the repository. - `repo_name: string` The name of the repository. - `type: "github" | "gitlab"` The source control management provider. - `"github"` - `"gitlab"` - `subdomain?: string` The Cloudflare subdomain associated with the project. ### Example ```node import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const project = await client.pages.projects.get('this-is-my-project-01', { account_id: '023e105f4ecef8ad9ca31a8372d0c353', }); console.log(project.id); ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "id": "7b162ea7-7367-4d67-bcde-1160995d5", "canonical_deployment": { "id": "f64788e9-fccd-4d4a-a28a-cb84f88f6", "aliases": [ "https://branchname.projectname.pages.dev" ], "build_config": { "web_analytics_tag": "cee1c73f6e4743d0b5e6bb1a0bcaabcc", "web_analytics_token": "021e1057c18547eca7b79f2516f06o7x", "build_caching": true, "build_command": "npm run build", "destination_dir": "build", "root_dir": "/" }, "created_on": "2021-03-09T00:55:03.923456Z", "deployment_trigger": { "metadata": { "branch": "main", "commit_dirty": false, "commit_hash": "ad9ccd918a81025731e10e40267e11273a263421", "commit_message": "Update index.html" }, "type": "ad_hoc" }, "env_vars": { "foo": { "type": "plain_text", "value": "hello world" } }, "environment": "preview", "is_skipped": true, "latest_stage": { "ended_on": "2021-03-09T00:58:59.045655Z", "name": "deploy", "started_on": "2021-03-09T00:55:03.923456Z", "status": "success" }, "modified_on": "2021-03-09T00:58:59.045655Z", "project_id": "7b162ea7-7367-4d67-bcde-1160995d5", "project_name": "this-is-my-project-01", "short_id": "f64788e9", "source": { "config": { "deployments_enabled": true, "owner": "my-org", "owner_id": "12345678", "path_excludes": [ "string" ], "path_includes": [ "string" ], "pr_comments_enabled": true, "preview_branch_excludes": [ "string" ], "preview_branch_includes": [ "string" ], "preview_deployment_setting": "all", "production_branch": "main", "production_deployments_enabled": true, "repo_id": "12345678", "repo_name": "my-repo" }, "type": "github" }, "stages": [ { "ended_on": "2021-06-03T15:39:03.134378Z", "name": "queued", "started_on": "2021-06-03T15:38:15.608194Z", "status": "active" }, { "ended_on": null, "name": "initialize", "started_on": null, "status": "idle" }, { "ended_on": null, "name": "clone_repo", "started_on": null, "status": "idle" }, { "ended_on": null, "name": "build", "started_on": null, "status": "idle" }, { "ended_on": null, "name": "deploy", "started_on": null, "status": "idle" } ], "url": "https://f64788e9.ninjakittens.pages.dev", "uses_functions": true }, "created_on": "2017-01-01T00:00:00Z", "deployment_configs": { "preview": { "always_use_latest_compatibility_date": false, "build_image_major_version": 3, "compatibility_date": "2025-01-01", "compatibility_flags": [ "url_standard" ], "env_vars": { "foo": { "type": "plain_text", "value": "hello world" } }, "fail_open": true, "usage_model": "standard", "ai_bindings": { "AI_BINDING": { "project_id": "some-project-id" } }, "analytics_engine_datasets": { "ANALYTICS_ENGINE_BINDING": { "dataset": "api_analytics" } }, "browsers": { "BROWSER": {} }, "d1_databases": { "D1_BINDING": { "id": "445e2955-951a-43f8-a35b-a4d0c8138f63" } }, "durable_object_namespaces": { "DO_BINDING": { "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3" } }, "hyperdrive_bindings": { "HYPERDRIVE": { "id": "a76a99bc342644deb02c38d66082262a" } }, "kv_namespaces": { "KV_BINDING": { "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3" } }, "limits": { "cpu_ms": 100 }, "mtls_certificates": { "MTLS": { "certificate_id": "d7cdd17c-916f-4cb7-aabe-585eb382ec4e" } }, "placement": { "mode": "smart" }, "queue_producers": { "QUEUE_PRODUCER_BINDING": { "name": "some-queue" } }, "r2_buckets": { "R2_BINDING": { "name": "some-bucket", "jurisdiction": "eu" } }, "services": { "SERVICE_BINDING": { "environment": "production", "service": "example-worker", "entrypoint": "MyHandler" } }, "vectorize_bindings": { "VECTORIZE": { "index_name": "my_index" } }, "wrangler_config_hash": "abc123def456" }, "production": { "always_use_latest_compatibility_date": false, "build_image_major_version": 3, "compatibility_date": "2025-01-01", "compatibility_flags": [ "url_standard" ], "env_vars": { "foo": { "type": "plain_text", "value": "hello world" } }, "fail_open": true, "usage_model": "standard", "ai_bindings": { "AI_BINDING": { "project_id": "some-project-id" } }, "analytics_engine_datasets": { "ANALYTICS_ENGINE_BINDING": { "dataset": "api_analytics" } }, "browsers": { "BROWSER": {} }, "d1_databases": { "D1_BINDING": { "id": "445e2955-951a-43f8-a35b-a4d0c8138f63" } }, "durable_object_namespaces": { "DO_BINDING": { "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3" } }, "hyperdrive_bindings": { "HYPERDRIVE": { "id": "a76a99bc342644deb02c38d66082262a" } }, "kv_namespaces": { "KV_BINDING": { "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3" } }, "limits": { "cpu_ms": 100 }, "mtls_certificates": { "MTLS": { "certificate_id": "d7cdd17c-916f-4cb7-aabe-585eb382ec4e" } }, "placement": { "mode": "smart" }, "queue_producers": { "QUEUE_PRODUCER_BINDING": { "name": "some-queue" } }, "r2_buckets": { "R2_BINDING": { "name": "some-bucket", "jurisdiction": "eu" } }, "services": { "SERVICE_BINDING": { "environment": "production", "service": "example-worker", "entrypoint": "MyHandler" } }, "vectorize_bindings": { "VECTORIZE": { "index_name": "my_index" } }, "wrangler_config_hash": "abc123def456" } }, "framework": "framework", "framework_version": "framework_version", "latest_deployment": { "id": "f64788e9-fccd-4d4a-a28a-cb84f88f6", "aliases": [ "https://branchname.projectname.pages.dev" ], "build_config": { "web_analytics_tag": "cee1c73f6e4743d0b5e6bb1a0bcaabcc", "web_analytics_token": "021e1057c18547eca7b79f2516f06o7x", "build_caching": true, "build_command": "npm run build", "destination_dir": "build", "root_dir": "/" }, "created_on": "2021-03-09T00:55:03.923456Z", "deployment_trigger": { "metadata": { "branch": "main", "commit_dirty": false, "commit_hash": "ad9ccd918a81025731e10e40267e11273a263421", "commit_message": "Update index.html" }, "type": "ad_hoc" }, "env_vars": { "foo": { "type": "plain_text", "value": "hello world" } }, "environment": "preview", "is_skipped": true, "latest_stage": { "ended_on": "2021-03-09T00:58:59.045655Z", "name": "deploy", "started_on": "2021-03-09T00:55:03.923456Z", "status": "success" }, "modified_on": "2021-03-09T00:58:59.045655Z", "project_id": "7b162ea7-7367-4d67-bcde-1160995d5", "project_name": "this-is-my-project-01", "short_id": "f64788e9", "source": { "config": { "deployments_enabled": true, "owner": "my-org", "owner_id": "12345678", "path_excludes": [ "string" ], "path_includes": [ "string" ], "pr_comments_enabled": true, "preview_branch_excludes": [ "string" ], "preview_branch_includes": [ "string" ], "preview_deployment_setting": "all", "production_branch": "main", "production_deployments_enabled": true, "repo_id": "12345678", "repo_name": "my-repo" }, "type": "github" }, "stages": [ { "ended_on": "2021-06-03T15:39:03.134378Z", "name": "queued", "started_on": "2021-06-03T15:38:15.608194Z", "status": "active" }, { "ended_on": null, "name": "initialize", "started_on": null, "status": "idle" }, { "ended_on": null, "name": "clone_repo", "started_on": null, "status": "idle" }, { "ended_on": null, "name": "build", "started_on": null, "status": "idle" }, { "ended_on": null, "name": "deploy", "started_on": null, "status": "idle" } ], "url": "https://f64788e9.ninjakittens.pages.dev", "uses_functions": true }, "name": "this-is-my-project-01", "preview_script_name": "pages-worker--1234567-preview", "production_branch": "main", "production_script_name": "pages-worker--1234567-production", "uses_functions": true, "build_config": { "web_analytics_tag": "cee1c73f6e4743d0b5e6bb1a0bcaabcc", "web_analytics_token": "021e1057c18547eca7b79f2516f06o7x", "build_caching": true, "build_command": "npm run build", "destination_dir": "build", "root_dir": "/" }, "domains": [ "customdomain.com", "customdomain.org" ], "source": { "config": { "deployments_enabled": true, "owner": "my-org", "owner_id": "12345678", "path_excludes": [ "string" ], "path_includes": [ "string" ], "pr_comments_enabled": true, "preview_branch_excludes": [ "string" ], "preview_branch_includes": [ "string" ], "preview_deployment_setting": "all", "production_branch": "main", "production_deployments_enabled": true, "repo_id": "12345678", "repo_name": "my-repo" }, "type": "github" }, "subdomain": "helloworld.pages.dev" }, "success": true } ```