Reputation
Submit phone numbers for reputation remediation
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
Path parameters
enterprise_idstring uuid required
Example:4a6192a4-573d-446d-b3ce-aff9117272a6
The enterprise id. Lowercase UUID.
Request body
Example request
{
"call_purpose": "Appointment reminders for our dental clinic.",
"contact_email": "ops@example.com",
"phone_numbers": [
"+19493253498"
],
"webhook_url": "https://example.com/webhooks/remediation"
}Response
Remediation request accepted and persisted.
Example response
{
"data": {
"call_purpose": "Appointment reminders for our dental clinic.",
"contact_email": "ops@example.com",
"created_at": "2026-06-01T12:00:00Z",
"id": "b7c1f1c0-7a9d-4f0a-9d3e-2f6a1c4b8e21",
"phone_numbers_count": 2,
"phone_numbers_submitted": 2,
"results": {
"remediated": [
"+19493253498"
]
},
"status": "in_progress",
"updated_at": "2026-06-01T12:05:00Z",
"webhook_url": "https://example.com/webhooks/remediation"
}
}