Delete record

DELETE
https://dennis.localhost/api/v1/records/{record}

If successful, this endpoint will return a 200 OK status.

Arguments

The following arguments are supported for this endpoint.

Name Type Default Value

record

Record Lookup None

Potential Errors

The following errors may occur during this request.

Details HTTP status

deletion_restricted

The object cannot be deleted at this time

409 Conflict

managed_records_cannot_be_deleted

409 Conflict

record_not_found

No record could be found using the given arguments

404 Not Found

Returned Object

When the request is successful, you can expect an object matching the specification below to be returned.

{
    record: Record {
        id: Integer
        name: String?
        external_reference: String?
        type: Record types
        full_name: String
        ttl: Integer?
        priority: Integer?
        managed: Boolean
        created_at: Unix Timestamp
        updated_at: Unix Timestamp
        tags: [ String ]
        raw_content: String
        content: RecordContentAttributes {
            A: RecordContentAttributesForA? {
                ip_address: String?
            }
            AAAA: RecordContentAttributesForAAAA? {
                ip_address: String?
            }
            ALIAS: RecordContentAttributesForALIAS? {
                hostname: String?
            }
            CAA: RecordContentAttributesForCAA? {
                flag: String?
                tag: String?
                value: String?
            }
            CNAME: RecordContentAttributesForCNAME? {
                hostname: String?
            }
            MX: RecordContentAttributesForMX? {
                hostname: String?
            }
            NS: RecordContentAttributesForNS? {
                hostname: String?
            }
            PTR: RecordContentAttributesForPTR? {
                hostname: String?
            }
            SOA: RecordContentAttributesForSOA? {
            }
            SRV: RecordContentAttributesForSRV? {
                weight: String?
                port: String?
                target: String?
            }
            SSHFP: RecordContentAttributesForSSHFP? {
                algorithm: String?
                fingerprint_type: String?
                fingerprint: String?
            }
            TXT: RecordContentAttributesForTXT? {
                content: String?
            }
            IPS: RecordContentAttributesForIPS? {
                ip_addresses: String?
            }
        }
        zone: Zone {
            id: Integer
            name: String
            group: Group {
                id: Integer
                name: String
                external_reference: String?
                created_at: Unix Timestamp
                updated_at: Unix Timestamp
                nameservers: [ Nameserver {
                    id: Integer
                    name: String
                    server: Integer
                    available: Boolean
                    created_at: Unix Timestamp
                    updated_at: Unix Timestamp
                } ]
            }
            created_at: Unix Timestamp
            updated_at: Unix Timestamp
            serial: Integer
            default_ttl: Integer
            external_reference: String?
            verified: Boolean
            nameservers_verified_at: Unix Timestamp?
            nameservers_checked_at: Unix Timestamp?
            always_verified: Boolean
            nameservers_verified: Boolean
            reverse_dns: Boolean
            stale_verification: Boolean
        }
    }
}