---
title: "Add and remove domains from Watchlist or Ignored lists."
method: PATCH
path: "/v1/iris-detect/domains/"
tags: ["Iris Detect"]
---

# Add and remove domains from Watchlist or Ignored lists.

`PATCH /v1/iris-detect/domains/`

## Request

- Base URL: `https://api.domaintools.com`
- URL: `https://api.domaintools.com/v1/iris-detect/domains/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP basic
  - API key in query parameter `signature`
- TypeScript: <https://skmtc.dev/domaintools/apis/domaintools-iris-api/docs/v1/iris-detect/domains/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- WatchlistState
  - `watchlist_domain_ids` string[]
  - `app_partner` string: A short identifier, code, or handle.
  - `app_name` string: A short identifier, code, or handle.
  - `app_version` string: A short identifier, code, or handle.
  - `state` 'watched' | 'ignored'

## Response `200`

OK

- Watchlist
  - `watchlist_domains` object[]
    - `state` 'watched' | 'ignored'
    - `domain` string
    - `discovered_date` string
    - `changed_date` string
    - `id` string
    - `assigned_by` string
    - `assigned_date` string

## Other responses

- `400`: 400: Bad Request. The request was invalid. The response will contain details about the error.
- `401`: 401: Unauthorized. API credentials are required and were not provided, or the provided credentials are not valid.
- `403`: 403: Forbidden. The API credentials provided do not have access to the requested resource or endpoint.
- `404`: 404: Not Found. The requested resource does not exist.
- `422`: 422: Unprocessable Entity. The request is syntactically valid JSON but contains values that fail validation. The response includes per-field error messages.

---

[API](https://skmtc.dev/domaintools/apis/domaintools-iris-api.md) - [All operations](https://skmtc.dev/domaintools/apis/domaintools-iris-api/llms.txt) - [OpenAPI document](https://skmtc.dev/domaintools/apis/domaintools-iris-api/revisions/74a0d057a130?raw)