CorefinityCorefinityDocs
Open the Control PanelControl Panel
Platform tools · 2 of 4

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.

POST/api/corestack/sites/{site}/admin-login/reset

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.

Body

confirmbooleanRequired

Always true: the reset replaces the password. Left out or false, the request is refused 422 on confirm.

usernamestring or null

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
commandobjectRequired

One run of a platform tool or another command on a site.

Fields
blocked_until_verifiedboolean
duration_msinteger or null
errorstring or nullRequired
exit_codeinteger or null
finished_atstring or nullRequired

Format: date-time.

idintegerRequired

At least 1.

inputany

The inputs the run was given. Never a secret.

kindstringRequired

The key of what ran, such as flush_cache.

labelstringRequired
operation_idinteger or null
output_excerptstring or null
queued_atstring or nullRequired

Format: date-time.

requested_byobject or any or null
resultanyRequired

What the run answered, by tool.

siteobjectRequired

A site by its id and domain.

Fields
domainstringRequired
idintegerRequired
started_atstring or nullRequired

Format: date-time.

statusstringRequired

succeeded, failed, timed_out and lost are final.

queuedrunningsucceededfailedtimed_outlost
status_labelstringRequired
secretobject

The new login, once. Only when the run has finished.

Fields
passwordstringRequired
revealed_atstring

Format: date-time.

urlstring or null

The address to sign in at.

usernamestringRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409busyAnother operation is running on the site. Wait for it to finish.
409command_runningAnother action or command is still running on the site. Wait for it to finish, then try again.
409deletedThe 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.
409exec_unresolvedAn earlier command on the site has not been confirmed stopped. Contact support.
409managed_elsewhereThis site is read-only here. Change it in the control panel that manages it.
409not_availableThe tool does not apply to this object.
409not_runningThe 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.
409provisioningThe site is still being created. Try again in a few minutes.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
503switched_offCorefinity 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
  }'
{
  "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"
  }
}
Try it

Try it is off for this endpointIt runs commands on a live site. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT