---
title: "Change the project | Proxy Mail QA"
description: "Developer docs for Proxy Mail QA: the MCP server for coding agents, the REST API for test suites, and the Chrome extension."
url: https://proxymail.qa/docs/reference/operations/updateproject
---

# Change the project

PATCH

/v1/project

```js
const url = 'https://api.proxymail.qa/v1/project';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","website":"example","environments":["example"],"email_prefix":"example","mail_domain":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request PATCH \
  --url https://api.proxymail.qa/v1/project \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "website": "example", "environments": [ "example" ], "email_prefix": "example", "mail_domain": "example" }'
```

Changes the key’s project: its name, website, environments, email prefix or default mail domain, as in Project settings. Only the fields given change. It needs the project’s lead (or an organisation owner or admin), the same as in the app, and each change is in the project’s activity log. Archiving, deleting and keeping whole emails stay in the app.

## Authorizations

- **[apiKey](https://proxymail.qa/docs/reference.html#apikey)**

## Request Bodyrequired

Media typeapplication/json

### object

\>= 1 properties

**name**

string

<= 80 characters

**website**

The app under test, such as <https://staging.example.com>; empty or null to remove it.

string | null

<= 300 characters

**environments**

Such as \[“staging”, “local”\].

Array<string>

<= 10 items

**email\_prefix**

Letters or digits new addresses start with; empty or null to remove it.

string | null

<= 12 characters

**mail\_domain**

One of the mail domains GET /v1/project lists.

string

### Example generated

```json
{
  "name": "example",
  "website": "example",
  "environments": [
    "example"
  ],
  "email_prefix": "example",
  "mail_domain": "example"
}
```

## Responses

### 200

The project, as GET /v1/project returns it

Media typeapplication/json

### object

#### Example generated

```json
{}
```

### 400

An error

Media typeapplication/json

### object

**error**

string

**message**

string

#### Example generated

```json
{
  "error": "example",
  "message": "example"
}
```

### 401

An error

Media typeapplication/json

### object

**error**

string

**message**

string

#### Example generated

```json
{
  "error": "example",
  "message": "example"
}
```

### 403

An error

Media typeapplication/json

### object

**error**

string

**message**

string

#### Example generated

```json
{
  "error": "example",
  "message": "example"
}
```

[Previous The key's project, its mail domains and limits](https://proxymail.qa/docs/reference/operations/getproject.html) [Next Mark a host as a dev environment](https://proxymail.qa/docs/reference/operations/adddevhost.html)

- [English ](https://proxymail.qa/docs/reference/operations/updateproject)
- [DeutschStartseite](https://proxymail.qa/de)
- [EspañolPágina de inicio](https://proxymail.qa/es)
- [FrançaisPage d’accueil](https://proxymail.qa/fr)
- [日本語トップページ](https://proxymail.qa/jp)
- [简体中文首页](https://proxymail.qa/zh-cn)