Update a site's MariaDB version
Moves the site's database to the next MariaDB version. MariaDB moves forward only, one version at a time. Answers the operation that makes the change.
Path parameters
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
When a change that needs a maintenance window is applied. now applies it at once. tonight queues it for the site's next window. window means the same as tonight. An endpoint that takes window only while maintenance windows are on for your company says so, and refuses it 422 on apply otherwise. Defaults to now.
nowtonightwindowThe MariaDB version to move to, as major and minor. Up to 8 characters.
Returns
201 The change started (the operation), or was queued for the site's window (queued).
202 The change was sent and its outcome is still being established: the operation is pending. Follow it by its id; it settles as saved or as failed within a few minutes. Do not send the change again meanwhile. Poll the operation until it finishes.
Fields of the 201 answer
Fields of the 202 answer
Who asked for the change.
Where a change is. completed and failed are final; every other status means the change is still running and blocks another change to the same site.
pendingcommittedrolling_outexecutingcompletedfailedFields of each item
One of done, current, todo, failed or skipped.
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 | none | Check the id. You see only what your account can reach. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
422 | invalid | Fix the field named in field; errors says why. |
422 | temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
422 | feature_off | This feature is not on for your organisation yet. |
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/mariadb-version \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"to": "11.8"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/sites/1042/mariadb-version', [
'to' => '11.8',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/mariadb-version', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
to: '11.8',
}),
});
// 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/mariadb-version",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"to": "11.8",
},
)
data = res.json() if res.content else None{
"committed_at": "2026-11-09T21:35:25+00:00",
"completed_at": null,
"created_at": "2026-11-09T21:35:25+00:00",
"error": null,
"from_version": "11.4",
"id": 5121,
"requested_by": {
"id": 2012,
"name": "Daniel Reyes"
},
"status": "committed",
"status_label": "Waiting for the platform",
"steps": [
{
"key": "saved",
"state": "done"
},
{
"key": "applied",
"state": "current"
},
{
"key": "restarted",
"state": "todo"
},
{
"key": "healthy",
"state": "todo"
}
],
"to_version": "11.8",
"type": "mariadb_version",
"type_label": "MariaDB version"
}{
"committed_at": null,
"completed_at": null,
"created_at": "2026-11-09T21:35:25+00:00",
"error": null,
"from_version": "11.4",
"id": 5121,
"requested_by": {
"id": 2012,
"name": "Daniel Reyes"
},
"status": "pending",
"status_label": "Saving change",
"steps": [
{
"key": "saved",
"state": "current"
},
{
"key": "applied",
"state": "todo"
},
{
"key": "restarted",
"state": "todo"
},
{
"key": "healthy",
"state": "todo"
}
],
"to_version": "11.8",
"type": "mariadb_version",
"type_label": "MariaDB version"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "busy",
"message": "Another change to this site is in progress. Wait for it to finish.",
"reason": "busy"
}{
"code": "invalid",
"errors": {
"to": [
"Upgrade one LTS release at a time"
]
},
"field": "to",
"message": "Upgrade one LTS release at a time",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"message": "The change could not be saved. Contact support."
}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.