Reveal a new site's admin login
Answers the admin login a fresh install created, once. Ask for it when the site's create has completed, with no body and Accept: application/json; the answer is never cached.
POST/ api/ corestack/ sites/ {site}/ provisioning/ reveal
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 login, shown this once.
Fields of the 200 answer
credentialsobjectRequired
Fields
adminobject or any or nullRequired
The admin login. Null for a platform whose install has no admin.
notestringRequired
revealed_atstringRequired
Format: date-time.
remainingintegerRequired
Always 0: the login is shown once.
revealed_atstringRequired
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. |
406 | none | Read the message; it says what happened. |
409 | already_revealed | A one-time secret was already shown. Reset it where the tool offers a reset. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/provisioning/reveal \
-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/provisioning/reveal');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/provisioning/reveal', {
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/provisioning/reveal",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"credentials": {
"admin": {
"password": "Example-admin-2026",
"url": "https://journal.harbourandfinch.example.com/wp-admin/",
"username": "shop_admin"
},
"note": "Shown once. Store it in your password manager.",
"revealed_at": "2026-11-19T09:20:00+00:00"
},
"remaining": 0,
"revealed_at": "2026-11-19T09:20:00+00:00"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "already_revealed",
"message": "These credentials were already shown. Reset them from the site page",
"reason": "already_revealed"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it
Try it is off for this endpointIt reveals a secret. Copy the request and run it yourself when you are sure.
Was this helpful?