Reveal a generated password once
Answers the password generated when the user was added or its password last rotated: once, within 24 hours, to the person who made that change, after its operation has completed. It needs the exec scope, the answer is never cached and the reveal is recorded.
POST/ api/ corestack/ sites/ {site}/ database/ users/ {username}/ 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.
usernamestringRequired
A database user's name, as the database details list it. Up to 128 characters.
Returns
200 The password, this once. Keep it out of logs and tickets.
Fields of the 200 answer
passwordstringRequired
The password, in plain text.
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 | feature_off | This feature is not on for your organisation yet. |
404 | user_not_found | There is no such database user on the environment. Read the users again. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
410 | reveal_gone | The password can no longer be shown. Rotate it to get a new one. |
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/database/users/reporting_ro/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/database/users/reporting_ro/reveal');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/database/users/reporting_ro/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/database/users/reporting_ro/reveal",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"password": "example-password-not-a-secret",
"username": "reporting_ro"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "managed_elsewhere",
"message": "This site is managed by another control panel",
"reason": "managed_elsewhere"
}{
"code": "reveal_gone",
"message": "This password can no longer be shown. Rotate it to get a new one.",
"reason": "reveal_gone"
}{
"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?