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

Set new attributes for an existing project. Modify environment variables. To delete an environment variable, set the key to null.

Servers

Path parameters

Name Type Required Description
project_name String Yes
account_id String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
production_branch String No

Production branch of the project. Used to identify production deployments.

source Object No

Configs for the project source control.

source.config Object Yes
source.config.preview_branch_includes[] Array No

A list of branches that should trigger a preview deployment. Wildcard syntax (*) is supported. Must be used with preview_deployment_setting set to custom.

source.config.repo_id String No

The ID of the repository.

source.config.path_includes[] Array No

A list of paths that should be watched to trigger a preview deployment. Wildcard syntax (*) is supported.

source.config.pr_comments_enabled Boolean No

Whether to enable PR comments.

source.config.preview_branch_excludes[] Array No

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.

source.config.production_deployments_enabled Boolean No

Whether to trigger a production deployment on commits to the production branch.

source.config.repo_name String No

The name of the repository.

source.config.production_branch String No

The production branch of the repository.

source.config.path_excludes[] Array No

A list of paths that should be excluded from triggering a preview deployment. Wildcard syntax (*) is supported.

source.config.deployments_enabled Boolean No

Whether to enable automatic deployments when pushing to the source repository. When disabled, no deployments (production or preview) will be triggered automatically.

source.config.preview_deployment_setting String No

Controls whether commits to preview branches trigger a preview deployment.

Valid values:

  • "custom"
  • "none"
  • "all"
source.config.owner String No

The owner of the repository.

source.config.owner_id String No

The owner ID of the repository.

source.type String Yes

The source control management provider.

Valid values:

  • "github"
  • "gitlab"
build_config Object No

Configs for the project build process.

build_config.build_caching Boolean No

Enable build caching for the project.

build_config.web_analytics_tag String No

The classifying tag for analytics.

build_config.destination_dir String No

Output directory of the build.

build_config.root_dir String No

Directory to run the command.

build_config.build_command String No

Command used to build project.

build_config.web_analytics_token String No

The auth token for analytics.

name String No

Name of the project.

deployment_configs Object No

Configs for deployments in a project.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.