Cloudflare API | Pages › Projects

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/pages/projects/$PROJECT_NAME \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \
    -d '{
      "build_config": {
        "build_caching": true,
        "build_command": "npm run build",
        "destination_dir": "build",
        "root_dir": "/",
        "web_analytics_tag": "cee1c73f6e4743d0b5e6bb1a0bcaabcc",
        "web_analytics_token": "021e1057c18547eca7b79f2516f06o7x"
      },
      "deployment_configs": {
        "preview": {
          "ai_bindings": {
            "AI_BINDING": {
              "project_id": "some-project-id"
            }
          },
          "analytics_engine_datasets": {
            "ANALYTICS_ENGINE_BINDING": {
              "dataset": "api_analytics"
            }
          },
          "browsers": {
            "BROWSER": {}
          },
          "compatibility_date": "2022-01-01",
          "compatibility_flags": [
            "url_standard"
          ],
          "d1_databases": {
            "D1_BINDING": {
              "id": "445e2955-951a-43f8-a35b-a4d0c8138f63"
            }
          },
          "durable_object_namespaces": {
            "DO_BINDING": {
              "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
            }
          },
          "env_vars": {
            "foo": {
              "value": "hello world",
              "type": "plain_text"
            }
          },
          "hyperdrive_bindings": {
            "HYPERDRIVE": {
              "id": "a76a99bc342644deb02c38d66082262a"
            }
          },
          "kv_namespaces": {
            "KV_BINDING": {
              "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
            }
          },
          "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": {
              "jurisdiction": "eu",
              "name": "some-bucket"
            }
          },
          "services": {
            "SERVICE_BINDING": {
              "entrypoint": "MyHandler",
              "environment": "production",
              "service": "example-worker"
            }
          },
          "vectorize_bindings": {
            "VECTORIZE": {
              "index_name": "my_index"
            }
          }
        },
        "production": {
          "ai_bindings": {
            "AI_BINDING": {
              "project_id": "some-project-id"
            }
          },
          "analytics_engine_datasets": {
            "ANALYTICS_ENGINE_BINDING": {
              "dataset": "api_analytics"
            }
          },
          "browsers": {
            "BROWSER": {}
          },
          "compatibility_date": "2022-01-01",
          "compatibility_flags": [
            "url_standard"
          ],
          "d1_databases": {
            "D1_BINDING": {
              "id": "445e2955-951a-43f8-a35b-a4d0c8138f63"
            }
          },
          "durable_object_namespaces": {
            "DO_BINDING": {
              "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
            }
          },
          "env_vars": {
            "BUILD_VERSION": {
              "value": "3.3",
              "type": "plain_text"
            },
            "delete_this_env_var": {
              "value": "value",
              "type": "plain_text"
            },
            "secret_var": {
              "value": "A_CMS_API_TOKEN",
              "type": "plain_text"
            }
          },
          "hyperdrive_bindings": {
            "HYPERDRIVE": {
              "id": "a76a99bc342644deb02c38d66082262a"
            }
          },
          "kv_namespaces": {
            "KV_BINDING": {
              "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
            }
          },
          "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": {
              "jurisdiction": "eu",
              "name": "some-bucket"
            }
          },
          "services": {
            "SERVICE_BINDING": {
              "entrypoint": "MyHandler",
              "environment": "production",
              "service": "example-worker"
            }
          },
          "vectorize_bindings": {
            "VECTORIZE": {
              "index_name": "my_index"
            }
          }
        }
      },
      "name": "NextJS Blog",
      "production_branch": "main"
    }'

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "result": {
    "build_config": {
      "build_caching": true,
      "build_command": "npm run build",
      "destination_dir": "build",
      "root_dir": "/",
      "web_analytics_tag": "cee1c73f6e4743d0b5e6bb1a0bcaabcc",
      "web_analytics_token": "021e1057c18547eca7b79f2516f06o7x"
    },
    "deployment_configs": {
      "preview": {
        "ai_bindings": {
          "AI_BINDING": {
            "project_id": "some-project-id"
          }
        },
        "analytics_engine_datasets": {
          "ANALYTICS_ENGINE_BINDING": {
            "dataset": "api_analytics"
          }
        },
        "browsers": {
          "BROWSER": {}
        },
        "compatibility_date": "2022-01-01",
        "compatibility_flags": [
          "url_standard"
        ],
        "d1_databases": {
          "D1_BINDING": {
            "id": "445e2955-951a-43f8-a35b-a4d0c8138f63"
          }
        },
        "durable_object_namespaces": {
          "DO_BINDING": {
            "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
          }
        },
        "env_vars": {
          "foo": {
            "value": "hello world",
            "type": "plain_text"
          }
        },
        "hyperdrive_bindings": {
          "HYPERDRIVE": {
            "id": "a76a99bc342644deb02c38d66082262a"
          }
        },
        "kv_namespaces": {
          "KV_BINDING": {
            "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
          }
        },
        "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": {
            "jurisdiction": "eu",
            "name": "some-bucket"
          }
        },
        "services": {
          "SERVICE_BINDING": {
            "entrypoint": "MyHandler",
            "environment": "production",
            "service": "example-worker"
          }
        },
        "vectorize_bindings": {
          "VECTORIZE": {
            "index_name": "my_index"
          }
        }
      },
      "production": {
        "ai_bindings": {
          "AI_BINDING": {
            "project_id": "some-project-id"
          }
        },
        "analytics_engine_datasets": {
          "ANALYTICS_ENGINE_BINDING": {
            "dataset": "api_analytics"
          }
        },
        "browsers": {
          "BROWSER": {}
        },
        "compatibility_date": "2022-01-01",
        "compatibility_flags": [
          "url_standard"
        ],
        "d1_databases": {
          "D1_BINDING": {
            "id": "445e2955-951a-43f8-a35b-a4d0c8138f63"
          }
        },
        "durable_object_namespaces": {
          "DO_BINDING": {
            "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
          }
        },
        "env_vars": {
          "foo": {
            "value": "hello world",
            "type": "plain_text"
          }
        },
        "hyperdrive_bindings": {
          "HYPERDRIVE": {
            "id": "a76a99bc342644deb02c38d66082262a"
          }
        },
        "kv_namespaces": {
          "KV_BINDING": {
            "namespace_id": "5eb63bbbe01eeed093cb22bb8f5acdc3"
          }
        },
        "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": {
            "jurisdiction": "eu",
            "name": "some-bucket"
          }
        },
        "services": {
          "SERVICE_BINDING": {
            "entrypoint": "MyHandler",
            "environment": "production",
            "service": "example-worker"
          }
        },
        "vectorize_bindings": {
          "VECTORIZE": {
            "index_name": "my_index"
          }
        }
      }
    },
    "name": "NextJS Blog",
    "production_branch": "main"
  },
  "success": false
}

Get Project -> Envelope<

Project

get/accounts/{account_id}/pages/projects/{project_name}

Fetch a project by name.

Get Projects -> SinglePage<

Deployment

get/accounts/{account_id}/pages/projects

Fetch a list of all user projects.

Purge Build Cache -> Envelope<unknown>

post/accounts/{account_id}/pages/projects/{project_name}/purge_build_cache

Purge all cached build artifacts for a Pages project

Domain types

Deployment = { id, aliases, build_config, 13 more... }

Project = { id, build_config, canonical_deployment, 8 more... }

Stage = { ended_on, name, started_on, 1 more... }

The status of the deployment.

Pages Projects

Deployments

pages.projects.deployments

Methods

Create Deployment -> Envelope<

Deployment

post/accounts/{account_id}/pages/projects/{project_name}/deployments

Start a new deployment from production. The repository and account must have already been authorized on the Cloudflare Pages dashboard.

Delete Deployment -> Envelope<unknown>

delete/accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}

Delete a deployment.

Get Deployment Info -> Envelope<

Deployment

get/accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}

Fetch information about a deployment.

Get Deployments -> SinglePage<

Deployment

get/accounts/{account_id}/pages/projects/{project_name}/deployments

Fetch a list of project deployments.

Retry Deployment -> Envelope<

Deployment

post/accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}/retry

Retry a previous deployment.

Rollback Deployment -> Envelope<

Deployment

post/accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}/rollback

Rollback the production deployment to a previous deployment. You can only rollback to succesful builds on production.

Pages Projects Deployments

History

pages.projects.deployments.history

Pages Projects Deployments History

Logs

pages.projects.deployments.history.logs

Methods

Get Deployment Logs -> Envelope<{ data, includes_container_logs, total }>

get/accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}/history/logs

Fetch deployment logs for a project.

Pages Projects

Domains

pages.projects.domains

Methods

Add Domain -> Envelope<{ id, certificate_authority, created_on, 6 more... }>

post/accounts/{account_id}/pages/projects/{project_name}/domains

Add a new domain for the Pages project.

Delete Domain -> Envelope<unknown>

delete/accounts/{account_id}/pages/projects/{project_name}/domains/{domain_name}

Delete a Pages project's domain.

Patch Domain -> Envelope<{ id, certificate_authority, created_on, 6 more... }>

patch/accounts/{account_id}/pages/projects/{project_name}/domains/{domain_name}

Retry the validation status of a single domain.

Get Domain -> Envelope<{ id, certificate_authority, created_on, 6 more... }>

get/accounts/{account_id}/pages/projects/{project_name}/domains/{domain_name}

Fetch a single domain.

Get Domains -> SinglePage<{ id, certificate_authority, created_on, 6 more... }>

get/accounts/{account_id}/pages/projects/{project_name}/domains

Fetch a list of all domains associated with a Pages project.