Delete Provider
Providers
Delete Provider
Permanently delete a telephony provider configuration
DELETE
Delete Provider
Documentation Index
Fetch the complete documentation index at: https://docs.unpod.dev/llms.txt
Use this file to discover all available pages before exploring further.
Delete Provider Configuration
Permanently delete a telephony provider configuration by its ID. Once deleted, this configuration can no longer be used to connect to bridges. This action cannot be undone.Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | Yes | Unique identifier of the provider configuration |
You can get the provider configuration
id by hitting the Get All Providers API.Headers
| Name | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | API Key format: Token <token> |
| Org-Handle | string | Yes | Organization domain handle |
Common Error Codes
| Status Code | Description |
|---|---|
| 204 | No Content - Configuration deleted successfully |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Invalid organization handle |
| 404 | Not Found - Provider configuration not found |
| 500 | Internal Server Error - Server-side error |
Code Examples
Best Practices
- Disconnect First: Always disconnect the provider from bridges before deleting a configuration
- Irreversible: Deletion is permanent — verify the correct
idbefore proceeding - Audit Trail: Note the deletion in your records for compliance and troubleshooting purposes
- 204 Response: A successful delete returns HTTP 204 with no body — handle this in your code
- Error Handling: Handle 404 gracefully — the configuration may have already been deleted