Reveal an HTTP authentication password
Answers one user's current password to the token's own person. Every reveal is recorded with who revealed it and when, and the answer is never cached.
POST/ api/ corestack/ sites/ {site}/ http-auth/ users/ {user}/ 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.
userintegerRequired
The id of an HTTP authentication user of this site, from the read. Digits only. At least 1.
Returns
200 The user's password, sent with Cache-Control: no-store, private.
Fields of the 200 answer
passwordstringRequired
revealed_atstringRequired
Format: date-time.
rule_idintegerRequired
At least 1.
user_idintegerRequired
At least 1.
usernamestringRequired
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. |
409 | legacy_hash | Carried from the previous environment as a legacy password hash: it signs in as before, but its password cannot be shown. Set a new password for it. |
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. |
502 | none | Read the message; it says what happened. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/http-auth/users/71/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/http-auth/users/71/reveal');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/http-auth/users/71/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/http-auth/users/71/reveal",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"password": "Example-client-2026",
"revealed_at": "2026-11-06T15:05:00Z",
"rule_id": 51,
"user_id": 71,
"username": "client"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "legacy_hash",
"message": "Carried from the previous environment as a legacy password hash: it signs in as before, but its password cannot be shown. Set a new password for it.",
"reason": "legacy_hash"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"message": "This password cannot be shown. Contact support."
}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?