# Asset Create

POST /easm/assets: Adds assets to monitoring. Send up to 1,000 domains, subdomains, IPs or website URLs in assets.

Source: https://docs.deepinfo.com/reference/easm/asset-create/

Last updated: 2026-09-27

---
`POST https://api.deepinfo.com/v1/easm/assets`

Adds assets to monitoring. Send up to 1,000 domains, subdomains, IPs or website URLs in `assets`. The response lists which were `created`, which `already_existed` and which were `invalid`. New assets are scanned automatically.

## Authentication

Send your API key in the `apikey` request header.

## Request Body

| Parameter | Type | Required | Description |
|---|---|---|---|
| `assets` | array | Required | min items `1`; max items `1000` |
| `description` | string | Optional |  |
| `portfolio_id` | string | Optional |  |

```json
{
  "assets": [
    "acme.example"
  ],
  "description": "Details of this record."
}
```

## Response Fields

| Field | Type |
|---|---|
| `created` | array of string |
| `already_existed` | array of string |
| `invalid` | array of string |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

| Field | Type |
|---|---|
| `created` | array<string> |
| `already_existed` | array |
| `invalid` | array |

## Examples

### 201 · Created

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/assets' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "assets": [
    "acme.example"
  ],
  "description": "Details of this record."
}'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "created": [
    "www.acme.example"
  ],
  "already_existed": [],
  "invalid": []
}
```

### 400 · Validation Error (empty body {})

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/assets' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "code": 10400,
  "parameters": [
    {
      "param": "assets",
      "details": [
        "This field is required."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```