Get a site's application version
Answers the line and version a site runs, when its line ends, and the line to move to when it is ending.
GET/ api/ corestack/ sites/ {site}/ app-version
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.
Returns
200 The site's version.
Fields of the 200 answer
built_for_onlyboolean
contentstring or nullRequired
created_forstring or null
The version the site was created with.
days_leftinteger or null
detectedobject or null
The version last read from the site itself, with when and from where.
differsboolean
display_versionstring or nullRequired
The version the Control Panel shows.
editionstring or nullRequired
edition_labelstring or null
eol_sincestring or null
eol_stagestringRequired
How close the line is to its end.
nonesoon_90soon_30endedinstalled_versionstring or null
linestring or nullRequired
line_labelstring or null
nextarrayRequired
The lines to move to when this one is ending.
next_lineobject or null
platformstringRequired
recognitionstringRequired
How the version was recognised, such as line.
security_untilstring or null
statusstring or nullRequired
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | feature_off | This feature is not on for your organisation yet. |
429 | rate_limited | Wait for the seconds in Retry-After. |
503 | catalogue_unavailable | Application versions are unavailable right now. Try again in a few minutes. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/app-version \
-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/sites/1042/app-version');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/app-version', {
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/sites/1042/app-version",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"built_for_only": false,
"content": "fresh",
"created_for": "7.0.7",
"days_left": null,
"detected": null,
"differs": false,
"display_version": "7.0.7",
"edition": null,
"edition_label": null,
"eol_since": null,
"eol_stage": "none",
"installed_version": "7.0.7",
"line": "7.0",
"line_label": "WordPress 7.0",
"next": [],
"next_line": null,
"platform": "wordpress",
"recognition": "line",
"security_until": null,
"status": "security"
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "catalogue_unavailable",
"message": "Application versions are unavailable right now. Try again in a few minutes.",
"reason": "catalogue_unavailable"
}Try it
Was this helpful?