Domain & DNS Tools

These tools give your agent full programmatic control over domains and DNS. Your agent can assign custom domains to services, manage DNS zones, and create any record type — enabling custom service routing, email configuration, domain verification, and more.

domain_add

Attach a custom domain to a deployed service. Creates a DNS record and configures TLS automatically.

Returns: service_id, domain, status, message

The domain must be within an active delegated zone. Ink creates the DNS record and provisions a TLS certificate automatically.

domain_remove

Remove a custom domain from a service. Reverts to the default *.deployink.com URL.

Returns: service_id, message

dns_list_zones

List all delegated DNS zones with their status. Zone delegation can be set up at deployink.com/dns.

Returns: Array of zones with zone_id, zone, status, error, created_at

Zone status values: pending_verification, pending_delegation, provisioning, active, failed

dns_list_records

List all DNS records within a delegated zone. Shows both user-created and managed (system) records.

Returns: Array of records with id, name, type, content, ttl, managed, created_at

dns_add_record

Add a DNS record to a hosted zone. Managed records (created by the system) cannot be overwritten.

Returns: record object with id, name, type, content, ttl, managed, created_at

Examples by record type

A record — Point a subdomain to an IP address:

dns_add_record(
  "zone": "apps.example.com",
  "name": "api",
  "type": "A",
  "content": "1.2.3.4"
)

MX record — Route email to a mail provider:

dns_add_record(
  "zone": "apps.example.com",
  "name": "@",
  "type": "MX",
  "content": "10 mail.example.com"
)

TXT record — Email authentication (SPF, DKIM, DMARC) or domain verification:

dns_add_record(
  "zone": "apps.example.com",
  "name": "@",
  "type": "TXT",
  "content": "v=spf1 include:_spf.google.com ~all"
)

CNAME record — Alias to another domain:

dns_add_record(
  "zone": "apps.example.com",
  "name": "docs",
  "type": "CNAME",
  "content": "docs.example.com"
)

CAA record — Restrict which CAs can issue certificates:

dns_add_record(
  "zone": "apps.example.com",
  "name": "@",
  "type": "CAA",
  "content": "0 issue letsencrypt.org"
)

dns_delete_record

Delete a DNS record from a delegated zone. Managed records (auto-created by Ink for custom domains) cannot be deleted.

Returns: message