Update a site's Node.js configuration
Changes the Node.js version, the global packages or follow mode: send the revision of your last read and what you change. A new package or a changed selector is pinned to the version it resolves to now on the public npm registry. Answers 201 with the operation that applies the change, or 200 when nothing differs or only follow mode changed. When the platform does not confirm the save, the 201 carries an operation that is still pending: follow it, and do not send the change again meanwhile.
- Needs
execas well: The packages turn install scripts on (scriptsis true) for a package that does not run them on that site now.
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
eol for a version past its end of life.
eolWhen 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.
nowtonightwindowWhen leaving Node.js 16, keep the tools that came with it as packages. Defaults to true.
The Node.js version to move to. The packages are installed again for it at their pinned versions.
The full list of global packages. A package left out is removed. Up to 20 items.
Fields of each item
The package's name on the public npm registry, with its @scope/ when it has one: lower-case letters, digits, -, ., _ and ~, at most 214 characters. Not a URL, a git or GitHub address, a file, a tarball or an npm alias. The name and the selector together are at most 255 bytes.
True to run the package's install scripts. Turning it on for a package that does not run them now needs the exec scope. Defaults to false.
A version (1.93.2), a range written without spaces (^1.90, >=1.2.0, 1.x, 1||2) or a tag (latest), at most 64 characters. A range with a space in it, such as >=1 <2, is refused package_spec_invalid. Left out, the newest version is pinned.
The revision of your last read. At least 0.
Names of listed packages to look up again for a newer version within their selector.
Returns
200 Nothing differs, or only follow mode changed. operation is null.
201 The change started (operation), or was queued for the site's window (queued).
Fields of the 200 answer
At least 1.
A site's Node.js configuration.
Fields
Whether a site is on the runtime, and whether it can move onto it.
Fields
Why the site cannot move at once, when it cannot.
True when the site is on the runtime.
The date Corefinity plans to move the site, if one is set.
The date of the window the move is queued for, if it is queued.
The runtime revision the site is on, such as v1. Null until it is on the runtime.
The Node.js change still running, what the site refused in the last one, and a change waiting for the window.
Fields
The window_date and item_id of a change that waits for the site's window.
The size of each package cache (npm_bytes, corepack_bytes, pnpm_bytes, yarn_bytes) and when it was measured. Null until the site has reported them.
True when each deployment switches to the version the repository asks for.
Format: date-time.
Fields
Set when Corefinity has locked the site's Node.js configuration, with the reason. Null otherwise.
The Node.js version the site is set to.
The memory of the site's command line (cli_limit_bytes) and Node.js's heap (heap_mib). Null until the site has reported them.
The versions the site may move to.
Fields of each item
What brings the version to the site when it is not there yet. Null when it is.
Whether the site, or a new site, has this version to hand.
What acknowledge must carry to choose it, such as eol.
Why it cannot be chosen, when it cannot.
Whether it can be chosen.
Such as active_lts, maintenance_lts or end_of_life.
Fields of each item
The security advisories of the last check, by severity.
Fields
The commands the installed package provides.
What went wrong when the package failed to install (message, tail). Null otherwise.
Null when the registry has not been asked.
The newest version on the registry at the last check, which may be outside the selector.
Where the line comes from. panel for one saved here or in the Control Panel.
The version the selector is pinned to.
Whether the package's install scripts run.
The version, range or tag asked for.
installed, installing, failed or pending.
The newest version within the selector at the last check.
What the repository asks for (source, raw, majors, satisfied, read_at), when it has been read. Null otherwise.
The write token. Send it back with every change; a change made since your read is refused stale.
The lifecycle of the site's version (key, label, end_of_life_on).
Global packages found on the site that were installed by hand, by name.
The full version the site reports, when it has reported one.
The operation that applies the change. Null when nothing differs, when only follow mode changed and when the change was queued.
Sent only when the change waits for the site's window.
Fields of each item
Sent only with queued, while maintenance windows are on for your company.
Fields of the 201 answer
At least 1.
A site's Node.js configuration.
Fields
Whether a site is on the runtime, and whether it can move onto it.
Fields
Why the site cannot move at once, when it cannot.
True when the site is on the runtime.
The date Corefinity plans to move the site, if one is set.
The date of the window the move is queued for, if it is queued.
The runtime revision the site is on, such as v1. Null until it is on the runtime.
The Node.js change still running, what the site refused in the last one, and a change waiting for the window.
Fields
The window_date and item_id of a change that waits for the site's window.
The size of each package cache (npm_bytes, corepack_bytes, pnpm_bytes, yarn_bytes) and when it was measured. Null until the site has reported them.
True when each deployment switches to the version the repository asks for.
Format: date-time.
Fields
Set when Corefinity has locked the site's Node.js configuration, with the reason. Null otherwise.
The Node.js version the site is set to.
The memory of the site's command line (cli_limit_bytes) and Node.js's heap (heap_mib). Null until the site has reported them.
The versions the site may move to.
Fields of each item
What brings the version to the site when it is not there yet. Null when it is.
Whether the site, or a new site, has this version to hand.
What acknowledge must carry to choose it, such as eol.
Why it cannot be chosen, when it cannot.
Whether it can be chosen.
Such as active_lts, maintenance_lts or end_of_life.
Fields of each item
The security advisories of the last check, by severity.
Fields
The commands the installed package provides.
What went wrong when the package failed to install (message, tail). Null otherwise.
Null when the registry has not been asked.
The newest version on the registry at the last check, which may be outside the selector.
Where the line comes from. panel for one saved here or in the Control Panel.
The version the selector is pinned to.
Whether the package's install scripts run.
The version, range or tag asked for.
installed, installing, failed or pending.
The newest version within the selector at the last check.
What the repository asks for (source, raw, majors, satisfied, read_at), when it has been read. Null otherwise.
The write token. Send it back with every change; a change made since your read is refused stale.
The lifecycle of the site's version (key, label, end_of_life_on).
Global packages found on the site that were installed by hand, by name.
The full version the site reports, when it has reported one.
The operation that applies the change. Null when nothing differs, when only follow mode changed and when the change was queued.
Sent only when the change waits for the site's window.
Fields of each item
Sent only with queued, while maintenance windows are on for your company.
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 | conflict | The action conflicts with the object's present state. Read the message. |
409 | runtime_locked | Corefinity has locked this environment's Node.js settings. Contact support to change them. |
409 | stale | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
422 | ack_required | Node.js 18 reached its end of life on 30 April 2025 and gets no security fixes. |
422 | scripts_memory | Install scripts need more command-line memory than the environment has. Choose a larger size, or leave install scripts off. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | none | Read the message; it says what happened. |
503 | switched_off | Corefinity has switched this action off for the moment. Try again later. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/node-runtime \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"follow_repository": true,
"revision": 4
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/sites/1042/node-runtime', [
'follow_repository' => true,
'revision' => 4,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/node-runtime', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
follow_repository: true,
revision: 4,
}),
});
// 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/node-runtime",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"follow_repository": True,
"revision": 4,
},
)
data = res.json() if res.content else None{
"node_runtime": {
"adopted": true,
"adoption": {
"adopt_now_refusal": null,
"adopted": true,
"can_adopt_now": false,
"can_adopt_tonight": false,
"in_progress": false,
"planned_for": null,
"queued_for": null,
"revision": "v1"
},
"apply": {
"error": null,
"operation": null,
"pending_tonight": null
},
"caches": null,
"follow_repository": false,
"last_applied_at": null,
"limits": {
"max_packages": 20
},
"locked": null,
"major": 24,
"memory": null,
"options": [
{
"arrives_with": null,
"available_on_this_row": true,
"codename": "Krypton",
"default_for_new": true,
"end_of_life_on": "2028-04-30",
"label": "Node.js 24",
"major": 24,
"needs_ack": [],
"reason": null,
"recommended": true,
"selectable": true,
"status": "maintenance_lts"
},
{
"arrives_with": null,
"available_on_this_row": true,
"codename": "Jod",
"default_for_new": false,
"end_of_life_on": "2027-04-30",
"label": "Node.js 22",
"major": 22,
"needs_ack": [],
"reason": null,
"recommended": false,
"selectable": true,
"status": "maintenance_lts"
}
],
"packages": [
{
"advisories": {
"critical": 0,
"high": 0
},
"bins": [],
"error": null,
"has_install_script": null,
"installed_version": null,
"latest": null,
"name": "sass",
"origin": "panel",
"resolved": "1.93.2",
"scripts": false,
"selector": "latest",
"state": "pending",
"update_available": false,
"wanted": null
},
{
"advisories": {
"critical": 0,
"high": 0
},
"bins": [],
"error": null,
"has_install_script": null,
"installed_version": null,
"latest": null,
"name": "sharp",
"origin": "panel",
"resolved": "0.34.4",
"scripts": true,
"selector": "0.34",
"state": "pending",
"update_available": false,
"wanted": null
}
],
"repository": null,
"revision": 4,
"status": {
"end_of_life_on": "2028-04-30",
"key": "maintenance_lts",
"label": "Maintenance LTS"
},
"unmanaged": [],
"version": null
},
"operation": null,
"warnings": [
{
"code": "already_newest",
"message": "Already the newest that matches."
}
]
}{
"item_id": 5120,
"node_runtime": {
"adopted": true,
"adoption": {
"adopt_now_refusal": null,
"adopted": true,
"can_adopt_now": false,
"can_adopt_tonight": false,
"in_progress": false,
"planned_for": null,
"queued_for": null,
"revision": "v1"
},
"apply": {
"error": null,
"operation": null,
"pending_tonight": {
"item_id": 5120,
"window_date": "2026-11-09"
}
},
"caches": null,
"follow_repository": false,
"last_applied_at": null,
"limits": {
"max_packages": 20
},
"locked": null,
"major": 24,
"memory": null,
"options": [
{
"arrives_with": null,
"available_on_this_row": true,
"codename": "Krypton",
"default_for_new": true,
"end_of_life_on": "2028-04-30",
"label": "Node.js 24",
"major": 24,
"needs_ack": [],
"reason": null,
"recommended": true,
"selectable": true,
"status": "maintenance_lts"
},
{
"arrives_with": null,
"available_on_this_row": true,
"codename": "Jod",
"default_for_new": false,
"end_of_life_on": "2027-04-30",
"label": "Node.js 22",
"major": 22,
"needs_ack": [],
"reason": null,
"recommended": false,
"selectable": true,
"status": "maintenance_lts"
}
],
"packages": [
{
"advisories": {
"critical": 0,
"high": 0
},
"bins": [],
"error": null,
"has_install_script": null,
"installed_version": null,
"latest": null,
"name": "sass",
"origin": "panel",
"resolved": "1.93.2",
"scripts": false,
"selector": "latest",
"state": "pending",
"update_available": false,
"wanted": null
},
{
"advisories": {
"critical": 0,
"high": 0
},
"bins": [],
"error": null,
"has_install_script": null,
"installed_version": null,
"latest": null,
"name": "sharp",
"origin": "panel",
"resolved": "0.34.4",
"scripts": true,
"selector": "0.34",
"state": "pending",
"update_available": false,
"wanted": null
}
],
"repository": null,
"revision": 4,
"status": {
"end_of_life_on": "2028-04-30",
"key": "maintenance_lts",
"label": "Maintenance LTS"
},
"unmanaged": [],
"version": null
},
"operation": null,
"queued": true,
"warnings": [],
"window_date": "2026-11-09"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "conflict",
"message": "Other changes to the platform kept landing first, so nothing was saved. Retry it.",
"reason": "conflict"
}{
"code": "ack_required",
"detail": {
"end_of_life_on": "2025-04-30",
"major": 18
},
"message": "Node.js 18 reached its end of life on 30 April 2025 and gets no security fixes.",
"reason": "ack_required",
"required": [
"eol"
]
}{
"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."
}{
"code": "switched_off",
"message": "Global package changes are paused while commands are switched off. Try again later.",
"reason": "switched_off"
}Try it is off for this endpointIt runs commands on a live site. Copy the request and run it yourself when you are sure.