DNS Records

Import an existing DNS record into temps management (explicit adoption)

Changed on
post/dns-records/import

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/dns-records/import
  • Auth: HTTP bearer

Request body

domainstring required

Domain (any FQDN under a managed zone)

environment_idinteger nullable

Environment this record belongs to (stamped into the ownership marker)

namestring required

Record name relative to the zone ("@" for apex)

project_idinteger nullable

Project this record belongs to (stamped into the ownership marker)

record_type'A' | 'AAAA' | 'CNAME' | 'TXT' | 'MX' | 'NS' | 'SRV' | 'CAA' | 'PTR' required

DNS record types

Example request

{
  "domain": "example.com",
  "name": "app"
}

Response

Record imported

environment_idinteger nullable

Environment stamped in the ownership marker

namestring required

Record name that was imported

project_idinteger nullable

Project stamped in the ownership marker

record_typestring required

Record type that was imported

Changes