Get the Node.js versions on offer
Answers the Node.js versions with their status and dates, the default for new sites, the curated packages and the limits. With site, each version says whether that site may move to it; with platform, whether a new site of that platform may use it.
Query parameters
The id of a site row, to answer what that site may move to. Digits only. At least 1.
A platform, such as wordpress, to answer what a new site of that platform may use. Any other value is refused 422. Ignored when site is sent.
Returns
200 The Node.js versions, the default, the curated packages and the limits.
Fields of the 200 answer
Packages suggested as quick picks.
Fields of each item
The version a new site starts on.
Fields
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.
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. |
422 | 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. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/node/catalogue \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/node/catalogue');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/node/catalogue', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// 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.get(
"https://manage.corefinity.com/api/corestack/node/catalogue",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"curated": [
{
"description": "Tailwind CSS on the command line, for building a theme's CSS.",
"name": "@tailwindcss/cli"
},
{
"description": "Compiles Sass and SCSS to CSS.",
"name": "sass"
},
{
"description": "Runs a project's gulp tasks.",
"name": "gulp-cli"
}
],
"default_for_new": 24,
"limits": {
"max_packages": 20
},
"majors": [
{
"arrives_with": null,
"available_on_this_row": true,
"codename": null,
"default_for_new": false,
"end_of_life_on": "2029-04-30",
"label": "Node.js 26",
"major": 26,
"needs_ack": [],
"reason": null,
"recommended": true,
"selectable": true,
"status": "active_lts"
},
{
"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": "Hydrogen",
"default_for_new": false,
"end_of_life_on": "2025-04-30",
"label": "Node.js 18",
"major": 18,
"needs_ack": [
"eol"
],
"reason": null,
"recommended": false,
"selectable": true,
"status": "end_of_life"
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid_arguments",
"errors": {
"which": [
"One or more of npm, corepack, pnpm, yarn, each once."
]
},
"field": "which",
"message": "Caches are named from npm, corepack, pnpm, yarn, each once.",
"reason": "invalid_arguments"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}