InboxKit

Delete DNS records

POST

https://api.inboxkit.com/v1/api/dns/delete

DNS

Maintainer:Not configured

Delete specific DNS records or all records for a domain

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.inboxkit.com/v1/api/dns/delete' \
--header 'X-Workspace-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Response Example

{
    "error": false,
    "message": "2 DNS records deleted successfully",
    "deleted_count": 2,
    "deleted_records": [
        {
            "host": "string",
            "value": "string",
            "type": "string"
        }
    ],
    "remaining_records": 3,
    "dns_record": {
        "uid": "string"
    },
    "records": [
        {
            "host": "string",
            "value": "string",
            "type": "string"
        }
    ]
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

X-Workspace-Id

string <uuid>

required

Workspace identifier

Body Params application/json

optional

Any of

anyOf {2}

Any of

object

domain

string

required

Domain name (required if uid not provided)

Example:

example.com

uid

string

optional

Domain UID (required if domain not provided)

record_ids

array[string]

required

Array of DNS record IDs to delete (required if delete_all is false)

delete_all

boolean

optional

Delete all DNS records for the domain

Default:

false

Examples

Responses

🟢200OK

application/json

DNS records deleted successfully

Body

error

boolean

optional

Example:

false

message

string

optional

Example:

2 DNS records deleted successfully

deleted_count

integer

optional

Number of records deleted

Example:

deleted_records

array [object {3}]

optional

Array of deleted records

host

string

optional

value

string

optional

type

string

optional

remaining_records

integer

optional

Number of remaining records (only for specific deletes)

Example:

dns_record

object

optional

Updated DNS record document

uid

string

optional

records

array [object {3}]

optional

host

string

optional

value

string

optional

type

string

optional

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Modified at 2025-06-20 08:13:43

Update DNS records

Export mailboxes status