---
title: "Mark a host as a dev environment | 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/adddevhost
---

# Mark a host as a dev environment

POST

/v1/project/dev-hosts

```js
const url = 'https://api.proxymail.qa/v1/project/dev-hosts';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"host":"example"}'
};

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

```sh
curl --request POST \
  --url https://api.proxymail.qa/v1/project/dev-hosts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "host": "example" }'
```

Adds a host to the project’s dev environments, as in Project settings: links to it in emails (an app running on localhost:3000, say) then pass the local-links check of /checks instead of failing it. Links to an unmarked localhost still fail.

## Authorizations

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

## Request Bodyrequired

Media typeapplication/json

### object

**host**

required

Host and port, or a page URL, such as localhost:3000.

string

<= 300 characters

### Example generated

```json
{
  "host": "example"
}
```

## Responses

### 200

The project’s dev hosts

Media typeapplication/json

### object

**dev\_hosts**

Array<string>

#### Example generated

```json
{
  "dev_hosts": [
    "example"
  ]
}
```

### 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 List or find addresses in the project, newest first](https://proxymail.qa/docs/reference/operations/listaddresses.html)