public-urls

Which of a custom domain’s DNS records are in place, and who hosts its DNS

Changed on

For a domain whose DNS is elsewhere. The records are looked up at the domain’s own nameservers (no cache in between), so a record shows here as soon as the provider serves it. zone is the domain’s DNS zone (example.com for app.example.com) and each record’s host is relative to it ("@" for the zone itself), the form most DNS providers ask for. status: ok, missing, or wrong (found lists what is there instead). provider names the DNS host, with a link to its DNS settings and tips (id other, named by the nameservers’ own domain, when it is not one Orgo knows; null when no nameservers answer). extra lists what would get in the way: another A or AAAA record at the name (some visitors would reach the old address), or a CAA record that leaves out Let’s Encrypt (no HTTPS certificate). A domain bought through Orgo answers provider orgo (Orgo DNS), where Orgo set the records. Changes nothing; POST /verify turns the domain on. 30 checks a minute per account.

get/api/computers/{id}/domains/{domainId}/dns-check

Request

  • Base URL
    https://www.orgo.ai
  • Auth
    HTTP bearer

Path parameters

idstring required

Computer id.

domainIdstring uuid required

Response

The check.

zonestring nullable required

The domain’s DNS zone, found from its nameservers; null when none answer.

checked_atstring date-time required

Example response

{
  "zone": "example.com",
  "provider": {
    "id": "cloudflare",
    "name": "Cloudflare",
    "dashboard_url": "https://dash.cloudflare.com/",
    "tips": [
      "Set Proxy status to DNS only."
    ]
  },
  "records": [
    {
      "type": "TXT",
      "name": "_orgo-verify.app.example.com",
      "host": "_orgo-verify.app",
      "value": "9f2c4e6a8b0d1f3e5a7c9e1b3d5f7a9c",
      "status": "ok",
      "found": [
        "9f2c4e6a8b0d1f3e5a7c9e1b3d5f7a9c"
      ]
    },
    {
      "type": "CNAME",
      "name": "app.example.com",
      "host": "app",
      "value": "edge.orgo.dev",
      "status": "missing",
      "found": []
    }
  ],
  "extra": [],
  "checked_at": "2026-10-21T18:00:00.000Z"
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      endpoint added