Reset an administrator's password
Sets a new password for an administrator of a WordPress, Magento 2 or Shopware site and answers it once. Leave username out to reset the administrator the site's current database was created with. The reset runs as one of the site's platform tools, so its limits and refusals are a tool run's.
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.
Body
Always true: the reset replaces the password. Left out or false, the request is refused 422 on confirm.
The administrator to reset. Left out, the one the site's current database was created with. On a WordPress or Magento 2 site, up to 60 letters, digits, _, ., @, + or -, never starting with + or -. On a Shopware site, up to 32 of the same characters, never starting with @, + or -. Anything else is refused 422 on username.
Returns
200 The password was reset. secret holds it, once.
Fields of the 200 answer
One run of a platform tool or another command on a site.
Fields
Format: date-time.
At least 1.
The inputs the run was given. Never a secret.
The key of what ran, such as flush_cache.
Format: date-time.
What the run answered, by tool.
A site by its id and domain.
Fields
Format: date-time.
succeeded, failed, timed_out and lost are final.
queuedrunningsucceededfailedtimed_outlostThe new login, once. Only when the run has finished.
Fields
Format: date-time.
The address to sign in at.
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 | busy | Another operation is running on the site. Wait for it to finish. |
409 | command_running | Another action or command is still running on the site. Wait for it to finish, then try again. |
409 | deleted | The site, environment or copy has been deleted, or is being deleted. Nothing can be changed on it. Restore a deleted site first if it can still be restored. |
409 | exec_unresolved | An earlier command on the site has not been confirmed stopped. Contact support. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
409 | not_available | The tool does not apply to this object. |
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. |
409 | provisioning | The site is still being created. Try again in a few minutes. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
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 -X POST https://manage.corefinity.com/api/corestack/sites/1042/admin-login/reset \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"confirm": true
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/admin-login/reset', [
'confirm' => true,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/admin-login/reset', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
confirm: true,
}),
});
// 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/admin-login/reset",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"confirm": True,
},
)
data = res.json() if res.content else None{
"command": {
"blocked_until_verified": false,
"duration_ms": 840,
"error": null,
"exit_code": 0,
"finished_at": "2026-11-10T00:59:43Z",
"id": 5122,
"input": null,
"kind": "wp_admin_reset",
"label": "Reset admin password",
"operation_id": null,
"output_excerpt": null,
"queued_at": "2026-11-10T00:59:43Z",
"requested_by": {
"id": 2041,
"name": "Eleanor Finch"
},
"result": null,
"site": {
"domain": "harbourandfinch.example.com",
"id": 1042
},
"started_at": "2026-11-10T00:59:42Z",
"status": "succeeded",
"status_label": "Done"
},
"secret": {
"password": "Example-new-password-1",
"revealed_at": "2026-11-10T00:59:43+00:00",
"url": "https://harbourandfinch.example.com/wp-admin/",
"username": "shop-admin"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "busy",
"message": "A change is being applied to this site. Wait for it to finish.",
"reason": "busy"
}{
"code": "invalid",
"errors": {
"confirm": [
"Confirm the action"
]
},
"field": "confirm",
"message": "Confirm the action",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "switched_off",
"message": "Site commands are switched off at the moment",
"reason": "switched_off"
}Try it is off for this endpointIt runs commands on a live site. Copy the request and run it yourself when you are sure.