Get a site's HTTP authentication
Answers the rules that ask visitors for a login, their users and the version every save sends back. A password is never part of this answer.
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 HTTP authentication set.
Fields of the 200 answer
Whether a saved set of rules is live on the site.
Fields
Sent only by the sets that have more to say, such as HTTP authentication.
The change that is applying the set, while one is running.
Such as applied or applying.
How many of Corefinity's own addresses are let past HTTP authentication.
Always empty for you. Corefinity's own addresses are let past HTTP authentication and are told to Corefinity staff only; bypass_corefinity counts them.
Whether an environment with this role starts protected.
Whether the whole environment asks for a login.
Fields
Fields of each item
At least 1.
The path the rule protects. Null for the whole environment.
Fields of each item
Format: date-time.
At least 1.
When the password was last revealed. 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 | none | Check the id. You see only what your account can reach. |
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/sites/1042/http-auth \
-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/http-auth');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/http-auth', {
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/http-auth",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"apply": {
"applied_at": "2026-11-06T15:01:10Z",
"detail": {
"credentials": "verified"
},
"error": null,
"operation": null,
"state": "applied",
"state_label": "Applied"
},
"bypass_corefinity": 1,
"bypass_ips": [],
"default_for_role": true,
"enabled": true,
"limits": {
"prefix_max": 200,
"rules_max": 20,
"users_per_rule_max": 10
},
"note": "Passwords are stored encrypted and shown only when you reveal them; every reveal is recorded.",
"rules": [
{
"enabled": true,
"id": 51,
"path_prefix": null,
"sort": 0,
"users": [
{
"created_at": "2026-11-04T10:00:00Z",
"id": 71,
"password_set": true,
"revealed_at": "2026-11-05T11:00:00Z",
"username": "client"
}
]
},
{
"enabled": true,
"id": 52,
"path_prefix": "/wp-admin/",
"sort": 1,
"users": [
{
"created_at": "2026-11-04T10:00:00Z",
"id": 72,
"password_set": true,
"revealed_at": null,
"username": "editor"
}
]
}
],
"version": 4
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}