---
title: "Update domain settings"
method: PATCH
path: "/domains/{id}"
tags: ["Domains"]
---

# Update domain settings

`PATCH /domains/{id}`

Update a verified domain's settings. Only verified domains can be
updated. Per-domain spam thresholds require a Pro plan.

## Request body

- object
  - `is_active` boolean — Whether the domain accepts incoming emails
  - `spam_threshold` number, nullable — Per-domain spam threshold override (Pro plan required)

## Response `200`

Updated domain

- object
  - `success` true, required
  - `data` object, required
    - `id` string, uuid, required
    - `org_id` string, uuid, required
    - `domain` string, required
    - `verified` true, required
    - `is_active` boolean, required
    - `spam_threshold` number, nullable
    - `verification_token` string, nullable
    - `created_at` string, date-time, required

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Resource not found

---

[API](https://skmtc.net/primitive/apis/primitive-api.md) · [All operations](https://skmtc.net/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primitive/primitive-api/versions/c2299d28022c/schema)