Docs / API / Delete Record

Delete Domain Record

Permanently remove a specific DNS record. To ensure the correct record is deleted, you must provide the exact type and value.

Destructive Action

This action is immediate and irreversible. If you delete a record by mistake, you will need to re-add it using the Add Record endpoint.

Endpoint

DELETEhttps://api.alinflow.com/v1/domain/records/delete

Headers

HeaderValueRequired
AuthorizationBearer <token>Yes
Content-Typeapplication/jsonYes

Body Parameters

ParameterTypeRequiredDescription
domainNamestringYesThe root domain name (e.g., example.com).
namestringYesThe name of the record (e.g., api or @).
typestringYesThe record type (e.g., A, MX).
valuestringYesThe exact content of the record to delete (e.g., 192.0.2.1).

Example Request

curl -X DELETE "https://api.alinflow.com/v1/domain/records/delete" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "domainName": "example.com",
    "name": "api",
    "type": "A",
    "value": "192.0.2.1"
  }'

Success Response

{
  "success": true,
  "message": "Record deleted successfully",
  "data": {
    "domain": "example.com",
    "deletedRecord": {
        "name": "api",
        "type": "A",
        "content": "192.0.2.1"
    }
  }
}