GaugeAPI docs
GuidesAPI referenceChangelogOpen console
API referenceCompliance

Add a number to the do-not-contact list

POST
/v2/dnc

No SMS or call goes to a listed number. Adding a listed number answers its existing entry.

Authorization

ApiKey
headerAuthorizationBearer <token>

An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).

Header Parameters

Gauge-Version?string

A dated version. Default 2026-10-21.

Idempotency-Key*string

Required on every POST. Retries with the same key replay the first response for 24 h.

Length1 <= length <= 255

Request Body

application/json
  1. body
e164*string
Match^\+[1-9]\d{6,14}$
reason?string
Length1 <= length <= 200

Response Body

The entry.

application/json
  1. response
id*string
Formatuuid
e164*string
reason*string|null
source*string
Value in"console""api""import"
createdAt*string
Example Request
curl -X POST 'https://app.gauge.chat/backend/v2/dnc' \  -H 'Idempotency-Key: string' \  -H 'Content-Type: application/json' \  -d '{  "e164": "string"}'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "e164": "string",  "reason": "string",  "source": "console",  "createdAt": "string"}

Who this key is GET

The key, the member it acts as, the workspace and plan, its scopes, environment and the rate-limit budget left. Any valid key may call it.

Get compliance settings GET

Quiet hours, the transactional exemption and the maximum API call length. Changed in the console (Settings → Compliance).