Disconnect Proxy

Returns the DNS configuration needed to restore the original DNS records and disconnect from the Search Company proxy. Supports:

Apex domains (example.com) - restores A records
Any subdomain (www, shop, blog, etc.) - restores CNAME

When to Use

Call this endpoint when a user wants to disconnect their domain from the Search Company proxy. This returns the Entri-compatible configuration to restore their domain back to its original DNS configuration. Important: After Entri completes the DNS restore, call /mark-disconnect-complete to update the proxy status.

What This Does

Looks up the original DNS records stored when the proxy was first set up
Returns DNS records that restore the domain to its original configuration
Optionally returns the SSL TXT record for cleanup (harmless to leave, but tidy to remove)
Does NOT delete CloudFront or SSL resources (they remain for fast reconnection)

Example Request

curl -X POST https://searchcompany-main.up.railway.app/api/domain/disconnect-proxy/org_xxx \
  -H "Authorization: Bearer YOUR_TOKEN"

Example Response (WWW Subdomain)

{
  "success": true,
  "custom_domain": "www.example.com",
  "domain_type": "subdomain",
  "subdomain_label": "www",
  "original_www_cname": "cname.vercel-dns.com",
  "original_apex_a_records": null,
  "original_apex_cname": null,
  "dns_records": [
    {
      "name": "www",
      "type": "CNAME",
      "value": "cname.vercel-dns.com"
    }
  ],
  "ssl_txt_record_to_delete": {
    "name": "_acme-challenge.www",
    "type": "TXT",
    "value": "abc123xyz789_validation_token"
  }
}

Example Response (Apex Domain)

{
  "success": true,
  "custom_domain": "example.com",
  "domain_type": "apex",
  "subdomain_label": "@",
  "original_www_cname": null,
  "original_apex_a_records": ["104.20.22.37", "172.66.165.95"],
  "original_apex_cname": null,
  "dns_records": [
    {
      "name": "@",
      "type": "A",
      "value": "104.20.22.37"
    },
    {
      "name": "@",
      "type": "A",
      "value": "172.66.165.95"
    }
  ],
  "ssl_txt_record_to_delete": null
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
custom_domain	string	The domain being disconnected
domain_type	string	apex or subdomain
subdomain_label	string	www, shop, @ for apex
original_www_cname	string	Original CNAME (for subdomains)
original_apex_a_records	string[]	Original A records (for apex domains)
original_apex_cname	string	Original CNAME if using flattening (rare)
dns_records	array	DNS records to restore via Entri
ssl_txt_record_to_delete	object	Optional TXT record to clean up

Frontend Integration

Use the response to configure Entri for the disconnect flow:

// Get disconnect config
const response = await disconnectProxy(orgId, token);

// Launch Entri with the restore DNS records
const entriConfig = {
  applicationId: ENTRI_APP_ID,
  token: entriToken,
  prefilledDomain: response.custom_domain.replace(/^[^.]+\./, ''),
  dnsRecords: response.dns_records.map(record => ({
    type: record.type,
    host: record.name,
    value: record.value,
    ttl: 300
  }))
};

Entri.showEntri(entriConfig);

// After Entri completes successfully
const onEntriClose = async (success: boolean) => {
  if (success) {
    await markDisconnectComplete(orgId, token);
  }
};

Complete Disconnect Flow

User clicks “Disconnect Domain”
Frontend calls /disconnect-proxy → gets restore DNS records
Entri restores www CNAME to original
Frontend calls /mark-disconnect-complete → sets proxy_status = “DISCONNECTED”
CloudFront + ACM stay intact (for fast relink later)

After Disconnect

After the user completes the disconnect flow:

Their domain points back to the original host
The CloudFront distribution remains but receives no traffic
The SSL certificate remains (auto-renews via ACM)
User can reconnect instantly by going through the 2-step DNS flow again (no CloudFront recreation needed)

Error Responses

Organization Not Found

{
  "detail": "Organization not found"
}

No Proxy Configuration

{
  "detail": "No proxy configuration found"
}

Missing Original DNS

{
  "detail": "Missing original CNAME for www. Cannot restore."
}

Getting Started

Website

Onboarding

Cron

Your Current Setup

Explore

Settings - Toggle

Settings - Business

Settings - Team

Settings - Billing

Settings - Domain

Webhooks

Health

Manual Trigger

When to Use

What This Does

Example Request

Example Response (WWW Subdomain)

Example Response (Apex Domain)

Response Fields

Frontend Integration

Complete Disconnect Flow

After Disconnect

Error Responses

Organization Not Found

No Proxy Configuration

Missing Original DNS

​When to Use

​What This Does

​Example Request

​Example Response (WWW Subdomain)

​Example Response (Apex Domain)

​Response Fields

​Frontend Integration

​Complete Disconnect Flow

​After Disconnect

​Error Responses

​Organization Not Found

​No Proxy Configuration

​Missing Original DNS

When to Use

What This Does

Example Request

Example Response (WWW Subdomain)

Example Response (Apex Domain)

Response Fields

Frontend Integration

Complete Disconnect Flow

After Disconnect

Error Responses

Organization Not Found

No Proxy Configuration

Missing Original DNS