Delete TLD Reminder
Permanently remove a previously configured reminder for a TLD (Top-Level Domain) by specifying its resource_id in the path. Once deleted, the system will no longer trigger notifications for the associated domain expiration or event.

This endpoint is useful for keeping your domain monitoring environment clean and relevant by discarding reminders that are outdated, no longer needed, or were set in error.

Common scenarios:
  • Domain decommissioning — Remove reminders tied to domains that are being retired or transferred.
  • Reminder cleanup — Delete unnecessary or duplicated reminders to reduce clutter in TLD settings.
  • Resetting configurations — Clear a reminder before re-adding it with updated settings.

To view all configured domain reminders, go to the TLD Settings page.

Expected Behavior:

  • On success, the TLD reminder will be deleted, and a confirmation message will be returned.
  • If the request is unauthorized or the provided ID is invalid, an error message will be returned, specifying the issue.


Authorization: Bearer YOUR_TOKEN

Path Parameters
  • id string
    The unique service ID for which the TLD reminder will be deleted.
    Example: 'c03b02ec-244f-4d2c-8f68-3910071ed5c8'
JavaScript
Response codes
const axios = require('axios');

const url = 'https://resource-cmd.api.pinghome.io/v1/tld/reminder/c03b02ec-244f-4d2c-8f68-3910071ed5c8';

axios.delete(url, {
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error);
});
ResponseThis section is used to view the possible HTTP response codes returned by the API. These codes indicate the status of a request, such as 201 (Created), 401 (Unauthorized), 409 (Conflict), or 422 (Unprocessable Entity).