Public Sites
Core Platformsites_readAI AgentShow which published apps are on the internet: their address, whether visitors need a password, and their custom domains with each domain's status and problems. An AI Agent sees only the apps it hosts. Use get for the exact DNS records a custom domain needs, then sites_write verify_domain once they're added. People turn sites on and add domains in the app.
Actions:
- list: List public sites. Apps with a site at the facility (including ones turned off), without DNS records.
- get: Get a public site. One site with every custom domain's DNS records: type, name (relative to the domain), host (full name), value and purpose (verify, route, route-alternative or caa). Needs appId.
Parameters
| Name | Type | Description |
|---|---|---|
action* | "list" | "get" | What to do; each action is described in the tool description. |
limit | integer | Items per page (default 25, at most 100) (list) |
cursor | string | nextCursor from the previous page (list) |
facilityId | string | Facility ID. Optional when the connected facility is the one you mean. |
appId | string | Published app id from sites_read list (get) |
sites_writeAI AgentCheck a custom domain's DNS records now and connect it to its site when they're right (the domain then serves the site over HTTPS). Get the records to add with sites_read get. Adding domains, turning sites on and setting passwords are done by people in the app.
Actions:
- verify_domain: Verify a custom domain. Returns the domain's status (pending, verified, failed or lapsed), any problems with their fixes, its records and a next step. Repeat checks within a few seconds return the last result. Needs appId, domain.
Parameters
| Name | Type | Description |
|---|---|---|
action* | "verify_domain" | What to do; each action is described in the tool description. |
appId | string | Published app id from sites_read list |
domain | string | A custom domain already added to the app's site, e.g. www.example.com |
facilityId | string | Facility ID. Optional when the connected facility is the one you mean. |