Reputation

Submit phone numbers for reputation remediation

Changed on

Submit a batch of phone numbers belonging to this enterprise for reputation remediation. The request is accepted asynchronously: this endpoint returns 202 with the persisted request id, then the request transitions through processing states until completion. Use the GET endpoints to poll status and per-number results.

Each phone number must be in E.164 format and belong to this enterprise. A number that already has an in-flight remediation request is rejected.

post/enterprises/{enterprise_id}/reputation/remediation

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/remediation
  • Auth: HTTP bearer

Path parameters

enterprise_idstring uuid required
Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

phone_numbersstring[] required

Phone numbers in E.164 format. Each must belong to this enterprise. Maximum 2,000 per request.

call_purposestring required

How the numbers are used (free text).

contact_emailstring email

Optional contact email for this remediation request.

webhook_urlstring uri

Optional https:// URL for status notifications.

Example request

{
  "phone_numbers": [
    "+19493253498"
  ],
  "call_purpose": "Appointment reminders for our dental clinic.",
  "contact_email": "ops@example.com",
  "webhook_url": "https://example.com/webhooks/remediation"
}

Response

Remediation request accepted and persisted.

Example response

{
  "data": {
    "id": "b7c1f1c0-7a9d-4f0a-9d3e-2f6a1c4b8e21",
    "status": "in_progress",
    "phone_numbers_count": 2,
    "phone_numbers_submitted": 2,
    "call_purpose": "Appointment reminders for our dental clinic.",
    "contact_email": "ops@example.com",
    "webhook_url": "https://example.com/webhooks/remediation",
    "created_at": "2026-06-01T12:00:00Z",
    "updated_at": "2026-06-01T12:05:00Z",
    "results": {
      "remediated": [
        "+19493253498"
      ]
    }
  }
}

Changes

  • da303e40b51eRevision changes
    • breaking

      the / response's property type changed from object to no type for status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added subschema #2 to the / response property anyOf list for the response status