Create 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.
Responses
200 Create deployment response.
Data is at
body["result"]
{
"aliases": [
"*string*"
],
"build_config": {
"build_caching": "*boolean*",
"build_command": "*string*",
"destination_dir": "*string*",
"root_dir": "*string*",
"web_analytics_tag": "*string*",
"web_analytics_token": "*string*"
},
"created_on": "*string*",
"deployment_trigger": {
"metadata": {
"branch": "*string*",
"commit_dirty": "*boolean*",
"commit_hash": "*string*",
"commit_message": "*string*"
},
"type": "*string*"
},
"env_vars": {},
"environment": "*string*",
"id": "*string*",
"is_skipped": "*boolean*",
"latest_stage": {
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
},
"modified_on": "*string*",
"project_id": "*string*",
"project_name": "*string*",
"short_id": "*string*",
"source": {
"config": {
"deployments_enabled": "*boolean*",
"owner": "*string*",
"owner_id": "*string*",
"path_excludes": [
"*string*"
],
"path_includes": [
"*string*"
],
"pr_comments_enabled": "*boolean*",
"preview_branch_excludes": [
"*string*"
],
"preview_branch_includes": [
"*string*"
],
"preview_deployment_setting": "*string*",
"production_branch": "*string*",
"production_deployments_enabled": "*boolean*",
"repo_id": "*string*",
"repo_name": "*string*"
},
"type": "*string*"
},
"stages": [
{
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
}
],
"url": "*string*",
"uses_functions": "*boolean*"
}4XX Create deployment response failure.
{
"errors": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"messages": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"result": {},
"success": "*boolean*"
}Get deployments
GET /accounts/{account_id}/pages/projects/{project_name}/deployments
Fetch a list of project deployments.
Responses
200 Get deployments response.
Data is at
body["result"]
[
{
"aliases": [
"*string*"
],
"build_config": {
"build_caching": "*boolean*",
"build_command": "*string*",
"destination_dir": "*string*",
"root_dir": "*string*",
"web_analytics_tag": "*string*",
"web_analytics_token": "*string*"
},
"created_on": "*string*",
"deployment_trigger": {
"metadata": {
"branch": "*string*",
"commit_dirty": "*boolean*",
"commit_hash": "*string*",
"commit_message": "*string*"
},
"type": "*string*"
},
"env_vars": {},
"environment": "*string*",
"id": "*string*",
"is_skipped": "*boolean*",
"latest_stage": {
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
},
"modified_on": "*string*",
"project_id": "*string*",
"project_name": "*string*",
"short_id": "*string*",
"source": {
"config": {
"deployments_enabled": null,
"owner": null,
"owner_id": null,
"path_excludes": null,
"path_includes": null,
"pr_comments_enabled": null,
"preview_branch_excludes": null,
"preview_branch_includes": null,
"preview_deployment_setting": null,
"production_branch": null,
"production_deployments_enabled": null,
"repo_id": null,
"repo_name": null
},
"type": "*string*"
},
"stages": [
{
"ended_on": null,
"name": null,
"started_on": null,
"status": null
}
],
"url": "*string*",
"uses_functions": "*boolean*"
}
]4XX Get deployments response failure.
{
"errors": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"messages": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"result": {},
"success": "*boolean*"
}Get deployment info
GET /accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}
Fetch information about a deployment.
Responses
200 Get deployment info response.
Data is at
body["result"]
{
"aliases": [
"*string*"
],
"build_config": {
"build_caching": "*boolean*",
"build_command": "*string*",
"destination_dir": "*string*",
"root_dir": "*string*",
"web_analytics_tag": "*string*",
"web_analytics_token": "*string*"
},
"created_on": "*string*",
"deployment_trigger": {
"metadata": {
"branch": "*string*",
"commit_dirty": "*boolean*",
"commit_hash": "*string*",
"commit_message": "*string*"
},
"type": "*string*"
},
"env_vars": {},
"environment": "*string*",
"id": "*string*",
"is_skipped": "*boolean*",
"latest_stage": {
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
},
"modified_on": "*string*",
"project_id": "*string*",
"project_name": "*string*",
"short_id": "*string*",
"source": {
"config": {
"deployments_enabled": "*boolean*",
"owner": "*string*",
"owner_id": "*string*",
"path_excludes": [
"*string*"
],
"path_includes": [
"*string*"
],
"pr_comments_enabled": "*boolean*",
"preview_branch_excludes": [
"*string*"
],
"preview_branch_includes": [
"*string*"
],
"preview_deployment_setting": "*string*",
"production_branch": "*string*",
"production_deployments_enabled": "*boolean*",
"repo_id": "*string*",
"repo_name": "*string*"
},
"type": "*string*"
},
"stages": [
{
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
}
],
"url": "*string*",
"uses_functions": "*boolean*"
}4XX Get deployment info response failure.
{
"errors": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"messages": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"result": {},
"success": "*boolean*"
}Delete deployment
DELETE /accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}
Delete a deployment.
Responses
200 Delete deployment response.
Data is at
body["result"]
{}4XX Delete deployment response failure.
{
"errors": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"messages": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"result": {},
"success": "*boolean*"
}Get deployment logs
GET /accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}/history/logs
Fetch deployment logs for a project.
Responses
200 Get deployment logs response.
Data is at
body["result"]
{
"data": [
{
"line": "*string*",
"ts": "*string*"
}
],
"includes_container_logs": "*boolean*",
"total": "*integer*"
}4XX Get deployment logs response failure.
{
"errors": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"messages": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"result": {},
"success": "*boolean*"
}Retry deployment
POST /accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}/retry
Retry a previous deployment.
Responses
200 Retry deployment response.
Data is at
body["result"]
{
"aliases": [
"*string*"
],
"build_config": {
"build_caching": "*boolean*",
"build_command": "*string*",
"destination_dir": "*string*",
"root_dir": "*string*",
"web_analytics_tag": "*string*",
"web_analytics_token": "*string*"
},
"created_on": "*string*",
"deployment_trigger": {
"metadata": {
"branch": "*string*",
"commit_dirty": "*boolean*",
"commit_hash": "*string*",
"commit_message": "*string*"
},
"type": "*string*"
},
"env_vars": {},
"environment": "*string*",
"id": "*string*",
"is_skipped": "*boolean*",
"latest_stage": {
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
},
"modified_on": "*string*",
"project_id": "*string*",
"project_name": "*string*",
"short_id": "*string*",
"source": {
"config": {
"deployments_enabled": "*boolean*",
"owner": "*string*",
"owner_id": "*string*",
"path_excludes": [
"*string*"
],
"path_includes": [
"*string*"
],
"pr_comments_enabled": "*boolean*",
"preview_branch_excludes": [
"*string*"
],
"preview_branch_includes": [
"*string*"
],
"preview_deployment_setting": "*string*",
"production_branch": "*string*",
"production_deployments_enabled": "*boolean*",
"repo_id": "*string*",
"repo_name": "*string*"
},
"type": "*string*"
},
"stages": [
{
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
}
],
"url": "*string*",
"uses_functions": "*boolean*"
}4XX Retry deployment response failure.
{
"errors": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"messages": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"result": {},
"success": "*boolean*"
}Rollback 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.
Responses
200 Rollback deployment response.
Data is at
body["result"]
{
"aliases": [
"*string*"
],
"build_config": {
"build_caching": "*boolean*",
"build_command": "*string*",
"destination_dir": "*string*",
"root_dir": "*string*",
"web_analytics_tag": "*string*",
"web_analytics_token": "*string*"
},
"created_on": "*string*",
"deployment_trigger": {
"metadata": {
"branch": "*string*",
"commit_dirty": "*boolean*",
"commit_hash": "*string*",
"commit_message": "*string*"
},
"type": "*string*"
},
"env_vars": {},
"environment": "*string*",
"id": "*string*",
"is_skipped": "*boolean*",
"latest_stage": {
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
},
"modified_on": "*string*",
"project_id": "*string*",
"project_name": "*string*",
"short_id": "*string*",
"source": {
"config": {
"deployments_enabled": "*boolean*",
"owner": "*string*",
"owner_id": "*string*",
"path_excludes": [
"*string*"
],
"path_includes": [
"*string*"
],
"pr_comments_enabled": "*boolean*",
"preview_branch_excludes": [
"*string*"
],
"preview_branch_includes": [
"*string*"
],
"preview_deployment_setting": "*string*",
"production_branch": "*string*",
"production_deployments_enabled": "*boolean*",
"repo_id": "*string*",
"repo_name": "*string*"
},
"type": "*string*"
},
"stages": [
{
"ended_on": "*string*",
"name": "*string*",
"started_on": "*string*",
"status": "*string*"
}
],
"url": "*string*",
"uses_functions": "*boolean*"
}4XX Rollback deployment response failure.
{
"errors": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"messages": [
{
"code": "*integer*",
"documentation_url": "*string*",
"message": "*string*",
"source": {
"pointer": "*string*"
}
}
],
"result": {},
"success": "*boolean*"
}