Check a site's packages for updates
Answers which global packages have a newer version within their selector or beyond it, and the security advisories reported for the installed set. The check runs on the site and is recorded in its activity; nothing installed changes. The person needs to be able to change the site, although the token needs only read.
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.
Returns
200 The packages with a newer version and the advisories.
Fields of the 200 answer
Fields of each item
ok when the advisories could be read.
The packages with a newer version.
Fields of each item
The newest version on the registry.
The newest version within the selector.
Format: date-time.
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 | not_running | The site, environment or deployment is not running. Read the message: where it can be started or will recover, start it or wait, then try again. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | node_check_failed | The package check answered something the control panel cannot read. |
503 | connect_failed | The cluster could not be reached. |
503 | temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
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 POST https://manage.corefinity.com/api/corestack/sites/1042/node-runtime/packages/check \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/node-runtime/packages/check');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/node-runtime/packages/check', {
method: 'POST',
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.post(
"https://manage.corefinity.com/api/corestack/sites/1042/node-runtime/packages/check",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"advisories": [
{
"installed": "2.8.0",
"name": "svgo",
"severity": "high",
"title": "Prototype pollution",
"url": "https://example.com/advisories/GHSA-0000-0000-0000"
}
],
"audit": "ok",
"outdated": [],
"read_at": "2026-11-09T21:35:28Z"
}{
"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 command is running on this site. Try again in a moment.",
"reason": "busy"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "node_check_failed",
"message": "The package check answered something the control panel cannot read.",
"reason": "node_check_failed"
}{
"code": "connect_failed",
"message": "The cluster could not be reached",
"reason": "connect_failed"
}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.