Update the zone's SSL mode
Sets the SSL/TLS mode of the site's Cloudflare zone to Full or Full (strict). The mode applies to every hostname in that zone.
PUT/ api/ corestack/ sites/ {site}/ cloudflare-zone/ ssl
Path parameters
siteintegerRequired
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Body
valuestringRequired
fullstrictReturns
200 The zone with its new mode.
Fields of the 200 answer
zoneobjectRequired
One Cloudflare zone of a company's connection.
Fields
dns01object or nullRequired
idstringRequired
Cloudflare's id for the zone. Send it as zone_id.
namestringRequired
permissionsobjectRequired
What the token may do in the zone.
Fields
cache_purgebooleanRequired
dns_editbooleanRequired
zone_settingsbooleanRequired
planstring or nullRequired
refreshed_atstring or nullRequired
Format: date-time.
sitesarray of objectsRequired
The sites mapped to the zone.
Fields of each item
mappingstringRequired
Whether the Control Panel matched the zone to the site or you chose it.
automanualsiteobjectRequired
Fields
domainstringRequired
idintegerRequired
At least 1.
ssl_modestring or nullRequired
ssl_okboolean or nullRequired
ssl_recommendedstring or nullRequired
statusstring or nullRequired
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | no_zone | The site's domain is not in a connected Cloudflare zone, or Cloudflare is off for the site. Connect the Cloudflare account that holds the zone. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | none | Read the message; it says what happened. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/cloudflare-zone/ssl \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"value": "strict"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/sites/1042/cloudflare-zone/ssl', [
'value' => 'strict',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/cloudflare-zone/ssl', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
value: 'strict',
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.put(
"https://manage.corefinity.com/api/corestack/sites/1042/cloudflare-zone/ssl",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"value": "strict",
},
)
data = res.json() if res.content else None{
"zone": {
"dns01": null,
"id": "023e105f4ecef8ad9ca31a8372d0c353",
"name": "harbourandfinch.example.com",
"permissions": {
"cache_purge": true,
"dns_edit": true,
"zone_settings": true
},
"plan": "Free",
"refreshed_at": "2026-11-06T09:19:48Z",
"sites": [
{
"mapping": "auto",
"site": {
"domain": "harbourandfinch.example.com",
"id": 1042
}
}
],
"ssl_mode": "strict",
"ssl_ok": true,
"ssl_recommended": "strict",
"status": "active"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "busy",
"message": "Another change to a Cloudflare zone is being made just now. Try again in a minute.",
"reason": "busy"
}{
"code": "invalid",
"errors": {
"value": [
"Choose Full or Full (strict)"
]
},
"field": "value",
"message": "Choose Full or Full (strict)",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many Cloudflare changes this hour. Try again later.",
"reason": "rate_limited",
"retry_after_seconds": 3600
}{
"message": "Cloudflare did not answer. Try again in a minute."
}Try it
Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.
Was this helpful?