This method allows you to update the settings of an existing DeployHQ project.

**Tip**: You can explore and test this endpoint interactively using our [OpenAPI documentation](https://api.deployhq.com/docs).

## URL

```
/projects/<project>/
```

Replace `<project>` with either the `permalink` or `identifier` of the project.

## HTTP Method

```
PUT
```

## Supported Parameters

* `name` - The name of your project
* `permalink` - The permalink of your project (note that changing this will stop automatic deployments from working due to the URL being different, therefore the URL in your repository will need to be updated)
* `email_notify_on` - If you wish for deployment events to send notification emails: 
  * `failure` (default) - only notify on failed deployments
  * `always` - notify on all deployments 
  * `never` - never notify on any deployments
* `notification_email` - A comma separated string of email addresses to send deployment notifications to
* `zone_id` - The region/zone that this project will be located in
  * `3` - UK (default)
  * `6` - US East 
  * `9` - US West

Note that the two email settings act as a default for the project, and can always be overridden on a per-server basis.

## Example cURL Request

```json
curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
-X PUT \
-d { \
  "project": { \ 
    "name":"Project", \
    "zone_id":3 \
  } \
}' \
https://test.deployhq.com/projects/project/
```

## Example Response

```json
{
  "name": "Project",
  "permalink": "project",
  "identifier": "05d8001c-9346-4a18-a7e6-057799f136a6",
  "url": "https://test.deployhq.com/projects/project",
  "app_url": "https://test.deployhq.com/projects/project",
  "servers_url": "https://test.deployhq.com/projects/project/servers",
  "deployments_url": "https://test.deployhq.com/projects/project/deployments",
  "config_files_url": "https://test.deployhq.com/projects/project/config_files",
  "environment_variables_url": "https://test.deployhq.com/projects/project/environment_variables",
  "build_commands_url": "https://test.deployhq.com/projects/project/build_commands"
}
```