corestack_ site_ smoke_ test
Smoke-test a site.
When to use it
Test a site from the Control Panel before or after its DNS moves: request up to 20 paths on one of its hosts (its platform hostname, an attached domain or a pending-DNS domain), always at the site's own address, so public DNS is never used for a request. Answers each path's status, redirects, timings, TLS state (the platform hostname's at its public edge) and page title, and the error lines the site logged meanwhile. Redirects are followed only to the site's own hosts on the standard ports; any other is reported as off_host_redirect and not followed. The preview login is sent for you and never shown.
The platform hostname's certificate lives at Corefinity's public edge, so its requests go to the site's own address without checking the certificate there, and its tls comes from one handshake to the hostname's public address instead: tls.via is edge, and tls.message says why when it is not valid (for example "The preview hostname has no DNS record."). The edge's answer never fails a check. Without host, a site that is not live yet is tested on its domain when its platform hostname has no DNS record.
Ask for it
Using the Corefinity MCP server, call corestack_site_smoke_test with site_id 4211, paths ["/",{"path":"/checkout","expect_status":200}]. (Smoke-test a site.) Tell me what it returned.Inputs
One of the site's hosts: its platform hostname, an attached domain or a pending-DNS domain. Default: the domain when the site is live or its platform hostname has no DNS, else the platform hostname. Up to 253 characters.
Defaults to GET.
GETHEADPaths to request, each "/path?query" or {path, expect_status}. Up to 20 items.
Fields of an item given as an object
100 to 599.
A path with an optional query, starting with /: no scheme, host or "..". Up to 2,048 characters.
At least 1.
Example call
{
"name": "corestack_site_smoke_test",
"arguments": {
"site_id": 4211,
"paths": [
"/",
{
"path": "/checkout",
"expect_status": 200
}
]
}
}If it is refused
| Reason | What to do |
|---|---|
managed_elsewhere | Another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done. |
invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
rate_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |