---
title: "Add Site Disarm Trusted Number"
method: POST
path: "/sites/{site_id}/disarm-trusted/numbers"
tags: ["sites"]
---

# Add Site Disarm Trusted Number

`POST /sites/{site_id}/disarm-trusted/numbers`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/sites/{site_id}/disarm-trusted/numbers`
- Auth: HTTP bearer

## Path parameters

- `site_id` string, required

## Request body

- AddDisarmTrustedNumberRequest: POST /sites/{id}/disarm-trusted/numbers: trust one more phone number.
  - `phone_number` string, required: A US phone number in any common format. Stored as E.164 (+18015550142); anything that is not a full 10-digit NANP number is refused with a 422.
  - `label` string, nullable: Who this is, for the list. Optional; not used in any message.
  - `site_contact_id` string, uuid, nullable: Provenance only: the site contact this number was picked from. It must belong to the SAME site. The number is COPIED, so a later contact edit never changes who is trusted, and being a contact grants nothing by itself.

## Response `201`

Successful Response

- DisarmTrustedNumberModel: One trusted number. Customer personal data: served only by the dedicated routes, never inside a site payload or the site tree.
  - `id` string, uuid, required: Unique id of the trusted number
  - `phone_number` string, required: Canonical E.164 number
  - `label` string, nullable: Who this is
  - `site_contact_id` string, uuid, nullable: The site contact this was picked from, if any. Provenance only; null once that contact is deleted.
  - `created_at` string, date-time, nullable: When it was added
  - `created_by_name` string, nullable: Who added it; null once that operator is deleted.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/35a2a6ebedda?raw)