Get what the application needs from PHP
Answers what the application asks of PHP, as last read from the site, with any extensions it needs that are not loaded and whether the PHP version is outside the range it accepts. refresh=1 reads the site again first, at most once every ten minutes. Try-it is off because that read runs a command on the site.
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.
Query parameters
Send 1 to read the running site again before answering.
10truefalseReturns
200 The requirements. Every field is null or empty until the site has been read once.
Fields of the 200 answer
Fields
Fields
For an extension, the packages that ask for it. An empty list when none is recorded.
The extensions the application needs, as ext-<name>.
The required extensions that are not loaded on the site, by name.
True when the site's PHP version is outside the range the application accepts.
Fields
The PHP range the application names, such as >=8.2.
The packages that name a PHP range of their own, each with name, version and constraint.
The PHP versions on offer that satisfy every range the application carries.
Format: date-time.
deploy (read from a deployment) or probe (read from the running site). Null before the first read.
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 | layout_unknown | The site's htdocs is not a release the control panel deployed, so the application's requirements cannot be read from it. |
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. |
422 | string | string. |
429 | rate_limited | Wait for the seconds in Retry-After. |
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 https://manage.corefinity.com/api/corestack/sites/1042/php-runtime/requirements \
-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/php-runtime/requirements');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/php-runtime/requirements', {
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/php-runtime/requirements",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"application": {
"name": "WordPress",
"version": "6.8.3"
},
"ext": {
"by": {
"imagick": [
"wordpress"
]
},
"required": [
"ext-json",
"ext-mysqli",
"ext-imagick"
]
},
"missing_extensions": [
"imagick"
],
"outside_range": false,
"php": {
"constraint": ">=7.4",
"packages": [],
"range": "8.4"
},
"read_at": "2026-11-08T09:16:40Z",
"source": "probe"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "layout_unknown",
"message": "The site's htdocs is not a release the control panel deployed, so the application's requirements cannot be read from it.",
"reason": "layout_unknown"
}{
"code": "string",
"detail_reason": "string",
"message": "string",
"reason": "string"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"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.