CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 5 of 12

Errors and refusals

How the API says no, status by status, and what to do about each reason.

On this page

A refusal carries a message in plain words and, where the API has a reason of its own, a stable reason. code always holds the same value as reason.

json
{
  "message": "Another change to this environment is not finished yet.",
  "reason": "operation_in_progress",
  "code": "operation_in_progress"
}

Statuses

StatusMeaningreason
401No token, or a token that is not validNone
403The token lacks a scope, two-factor authentication is not set up, or the person may not use thisscope_required, two_factor_required, company_not_enabled, or none
404Not found or not yours to see, or the feature is offNone, feature_off, or a named reason
409The request is fine but the current state refuses itNearly always
422A field is missing or wrong, or a rule refuses the requestinvalid, confirm_mismatch or a named reason
429Too many requestsrate_limited, or the name of a limit of the endpoint's own
502Something the request depends on could not be reachedNone, or a reason such as upstream_unavailable
503The action is switched off, or cannot be served, for the momentswitched_off, or a reason such as temporarily_unavailable

A more specific reason beside the reason

A few refusals keep the reason they have always answered and add the more specific word in detail_reason. Read detail_reason when it is present, else reason.

Wherereasondetail_reason
A database user's confirm_read_write that is typed and does not matchinvalidconfirm_mismatch
json
{
  "message": "A read-write user can change and delete data. Type read-write to confirm.",
  "errors": {
    "confirm_read_write": ["A read-write user can change and delete data. Type read-write to confirm."]
  },
  "reason": "invalid",
  "field": "confirm_read_write",
  "code": "invalid",
  "detail_reason": "confirm_mismatch"
}

A field that is missing or wrong

Most endpoints answer it this way. field names the first refused field and errors lists every one; an endpoint's reference page shows its own answer where it differs.

json
{
  "message": "The enabled field is required.",
  "errors": {
    "enabled": ["The enabled field is required."]
  },
  "reason": "invalid",
  "field": "enabled",
  "code": "invalid"
}

Some areas answer the same refusal as invalid_arguments. Treat the two codes alike.

Reasons you meet on any endpoint

StatusreasonWhat to do
403scope_requiredUse a token with the scope in scope; see Scopes
403two_factor_requiredSet up two-factor authentication; see Two-factor authentication
403company_not_enabledYour account has no company that can use Managed Clusters, for example because the company was closed. Ask Corefinity support
403company_unavailableYour account belongs to no company, or to a deleted one. Ask Corefinity support
403pending_orderYour company's first order is not finished. Finish it in the Control Panel, at the address in redirect
404None, "Not found."Check the id; see Identifiers
404feature_offThe feature is not on for your company
409managed_elsewhereThe site is managed by another control panel. Change it there
409busyAnother change to the site is running. Wait for its operation to finish
409staleWhat you read has changed. Read it again and send the change with the new version
422invalid, invalid_argumentsCorrect the fields named in errors
422confirm_mismatchSend the confirmation named in field exactly as the endpoint describes it
429rate_limitedWait for Retry-After seconds, which retry_after_seconds repeats; see Rate limits
503switched_offCorefinity has switched the action off for the moment. Try again later

Reasons by name

The reasons the reference shows an example answer for, under the area that answers each, with the statuses that area answers it with. A reason met in more than six areas stands once, under Several areas.

This is not every reason: an endpoint's reference page names each reason that endpoint answers, with its real message, and some are named there only.

Where one reason is answered in several areas the sentence here is general, and the message says what happened.

52 groups

Several areas

27
ReasonStatusWhat it means and what to do
busy409, 503Another change or command is running on what the request acts on. Wait for it to finish, then try again.
command_running409Another action or command is still running on the site. Wait for it to finish, then try again.
company_not_enabled403Your account has no company that can use Managed Clusters, for example because the company was closed. Ask Corefinity support.
company_unavailable403Your company cannot be used at the moment. Ask Corefinity support.
confirm422The action needs an explicit confirmation field. Ask the person, then send it.
confirm_mismatch409, 422A typed confirmation is missing or does not match. Send the confirmation named in field exactly as the message says; for scheduled tasks, send the labels in labels as confirm_labels.
conflict409The request conflicts with another one, or with what the object is now. Read the message, read the object again and send a request that fits it.
deleted409The 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.
exec_unresolved409An earlier command on the site has not been confirmed stopped. Contact support.
feature_off404, 422The feature, or the input that needs it, is not switched on. Leave that input out, or ask Corefinity about the feature.
forbidden403The person behind the token may not do this. Read the message: where a permission or role is missing it names it, and an owner of your company can grant it.
invalid422A field is missing or wrong. Correct the fields named in errors.
invalid_arguments422A field is missing or wrong. Correct the fields named in errors; treat it as invalid.
managed_elsewhere409The site is managed by another control panel. Make the change there.
not_available409, 422The request does not apply to this object as it is. The message says why.
not_running409The 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.
provisioning409The site is still being created. Try again in a few minutes.
rate_limited429Too many requests. Wait for the seconds in Retry-After, which retry_after_seconds repeats, then try again.
removed409The site or environment is being removed, or has been. Nothing can be changed on it.
restore_running409A restore is running on the site. Wait for it to finish, then try again.
scope_required403The token lacks the scope in scope. Use a token that holds it; see Scopes.
stale409, 422What you read has changed since you read it. Read it again, then send the change with its new version or quote.
switched_off503Corefinity has switched this kind of action off for the moment. Nothing was changed; try again later.
temporarily_unavailable422, 503The request is fine but cannot be served at the moment. Nothing was started; try again in a minute.
two_factor_required403Your company requires two-factor authentication and you have not set it up. Set it up on your profile; see Two-factor authentication.
upstream_unavailable409, 502, 503A service the request depends on did not answer. Nothing was changed; try again in a minute.
wrong_platform404, 409, 422This is not available for the site's platform. Use it on a site of the platform it is for.

Access

5
ReasonStatusWhat it means and what to do
in_use409It is still in use, still being removed, or managed somewhere else. Read the message: wait for the removal, remove what uses it first, or remove it where the message says.
restricted403Restricted keys are changed by Corefinity staff only. Ask Corefinity support.
ssh_key_duplicate409The key is already added here. Use the existing one.
ssh_person_managed_elsewhere422That username belongs to a person's own SSH login, managed in their profile. Choose another name.
ssh_throttled429Too many SSH key changes or host key rotations were sent. Wait a minute and try again.

Account security

2
ReasonStatusWhat it means and what to do
confirmation_required409Staying signed in longer needs you to confirm it is you. Confirm it in the Control Panel, then try again.
trust_above_session_limit422A trusted browser cannot skip the code for longer than you stay signed in. Choose a shorter time for the trusted browser, or a longer sign-in.

Application versions

1
ReasonStatusWhat it means and what to do
catalogue_unavailable503The list of versions could not be read. Nothing was changed; try again in a minute.

Billing

14
ReasonStatusWhat it means and what to do
billing_forbidden403Billing is for the organisation's owner and billing contacts. Ask one of them to do this.
billing_settling409The environment has been moved and its billing is still being updated. Try again in a few minutes.
contract_missing409There is no billing contract to price this against. Ask support to set up billing, or make the change without a quote where that is offered.
credit_note_not_ready404The credit note is not ready yet. Try again shortly.
currency_unpublished422Prices in that currency are not available right now. Choose another currency, or try again later.
downgrade409A smaller package cannot be chosen here. Choose a larger one; downgrades are arranged with support.
package_unknown422That is not a package Corefinity sells for this. Choose one from the catalogue.
pdf_missing404The invoice's PDF could not be found. Open a support ticket and Corefinity will send it.
pdf_pending409The invoice's PDF is not ready yet. Try again in a few minutes.
provider_unavailable503The payment provider, or the old host, did not answer. Try again later.
same_family409This is already the server type. Choose a different one.
same_package409This is already the package. Choose a different one.
zone_unknown422That is not a region. Choose uk, us, nl or aus.

Cloudflare

6
ReasonStatusWhat it means and what to do
no_zone409The site's domain is not in a connected Cloudflare zone, or Cloudflare is off for the site. Connect the Cloudflare account that holds the zone.
not_connected409, 422The outside account this needs is not connected for your company. Connect it first; the message names it.
not_owner409The Cloudflare rule belongs to another change, so it was left as it is. Wait for that change to finish.
rule_edited409The Cloudflare rule was changed in Cloudflare after the Control Panel set it, so it was left as it is. Change or remove it in Cloudflare.
rules_not_allowed422The Cloudflare token may not change the zone's rules. Allow Zone, Config Rules, Edit on the token, or connect one that can.
unavailable502This is not available for the site or environment, or not at the moment. Read the message; try again later where it says so, or contact support.

Copies

11
ReasonStatusWhat it means and what to do
clone_in_progress409Another copy is running on the site. Wait for it to finish.
copy_limit429Your company already has the most copies or restores it can run at once. Try again when one has finished.
copy_queued409A copy onto this environment already waits its turn. Cancel it first to queue another.
different_cluster409A copy works within one cluster, and the target is in another. Choose a target in the same cluster.
maintenance409The site is in maintenance mode, which blocks this. Switch maintenance mode off first.
not_waiting409The copy is no longer waiting, so it cannot be cancelled. Follow its operation instead.
snapshot_transfer422A saved snapshot can be copied only to an environment on the same servers for now. Copy the live environment instead, or restore the snapshot first.
ssh_unreachable409The environment to copy from cannot be reached. Try again in a few minutes.
target_busy409The environment to copy or restore into is busy with another change. Nothing was changed. Wait, then try again.
too_small409The target is too small for what it would hold. Choose a larger size.

CoreCluster

9
ReasonStatusWhat it means and what to do
cluster_busy409Another change to the cluster is running. Wait for it to finish, then try again.
cluster_deleting409The cluster is being deleted. Nothing can be changed on it.
cluster_not_empty409The CoreCluster still holds sites, environments, deleted sites or snapshots. Read what deleting it removes, then send the request again with allow_non_empty: true to delete everything on it.
compute_blocked409There is no server capacity for this size at the moment. Choose another size, or contact support.
duplicate409The same thing already exists here. Use the existing one, or choose another name or value.
legacy_cluster409Corefinity manages this cluster. Contact support to change its package or delete it.
region_unavailable409The region has no room for this at the moment. Choose another region, or try again later.
runtime_not_adopted422The site or cluster does not run the runtime this needs yet. Read the message: leave the input out, or ask Corefinity support about the runtime update.
staff_removal409The cluster holds something only Corefinity can remove. Contact support to delete it.

Create a site

10
ReasonStatusWhat it means and what to do
billing_forbidden403Billing is for the organisation's owner and billing contacts. Ask one of them to do this.
catalogue_unavailable503The list of versions could not be read. Nothing was changed; try again in a minute.
cleaning_up409The site, the environment or its last restore is still being cleaned up or removed. Try again in a few minutes.
commerce_check_unavailable503The Marketplace keys could not be checked. Try again in a few minutes.
duplicate409The same thing already exists here. Use the existing one, or choose another name or value.
no_payment_method409There is no payment method on the account. Add a card or a Direct Debit mandate first.
no_platform_cluster409The region has no CoreStack platform yet. Choose another region.
already_revealed409The one-time login was already shown. Reset the password where the endpoint offers a reset.
placement409The CoreCluster cannot take a site of this platform yet. Choose another placement, or ask Corefinity support.
platform_cluster409The cluster is the CoreStack platform, which has no settings or sites of its own to change this way. Change or create the site itself instead.

Database

15
ReasonStatusWhat it means and what to do
external_off422External access is off, and external users connect through it. Turn external access on first.
reveal_gone410The password can no longer be shown. Rotate it to get a new one.
unchanged422Nothing would change. Nothing to do.
user_cap422The environment holds as many database users as it can. Delete one you no longer need, or ask support.
user_not_found404There is no such database user on the environment. Read the users again.
billing_forbidden403Billing is for the organisation's owner and billing contacts. Ask one of them to do this.
change_pending409A change is already queued for tonight. Apply it now or cancel it first.
demo_keep_required409Creating CoreStack sites needs the demo to be kept first. Keep your demo, then try again.
external_db_already_off409External access is already off. Nothing to do.
external_db_already_on409External access is already on. Nothing to do.
external_db_failed409External access could not be turned on. Contact support so it can be finished or undone.
external_db_not_available422External access is not available on the environment yet. Ask support.
external_db_not_on409External access is off. Turn it on first.
external_db_unchanged409The allowed addresses are already exactly these. Nothing to do.
restart_batches_off409Changes cannot be queued for the maintenance window at the moment. Apply the change now instead.

Demos

10
ReasonStatusWhat it means and what to do
addon_bounds422An add-on quantity is outside what is allowed. Choose a whole number inside the range the message gives.
already_kept409The demo has already been kept. Nothing to do.
billing_details_required409Billing details are needed to keep the demo. Add them, then keep it.
demo_building409The demo is still being set up. Keep it once it is ready.
demo_closed409The demo has ended and can no longer be kept. Start an order to carry on.
forbidden_role403Keeping a demo needs the organisation's owner or a billing role. Ask the owner to keep it.
package_not_offered422The package chosen for the demo is not offered. Choose one that is.
package_platform422The package is not offered for the site's platform. Choose a package that is.
payment_method_required409A payment method is needed to keep the demo. Add one, then keep it.
privacy_required422The privacy notice has not been accepted. Accept it to keep the demo.

Deployment pipeline

8
ReasonStatusWhat it means and what to do
deployment_running409A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again.
line_credentials422A pipeline line holds a credential. Move the value into a variable, then save again.
maintenance_policy_unavailable422The platform has no pending-upgrade check, so that maintenance policy cannot be chosen. Choose Always or Off.
pipeline_classic409Corefinity still runs this pipeline in its classic form, so it cannot be edited yet. Contact Corefinity support.
pipeline_locked409Corefinity has locked this pipeline; the message says why. Contact Corefinity support to change it.
rehearsal_production409A rehearsal never runs on production. Rehearse on a staging environment of the site.
timeout_out_of_range422The timeout is outside what a stage may take. Choose a value in the range the message names.
version_unavailable422The version is not available here. Read the versions on offer and choose one of them.

Deployment templates

12
ReasonStatusWhat it means and what to do
exists409It already exists. Use the existing one.
reach_changed409The environments the change reaches have changed since you reviewed it. Read them again, then confirm.
secret_invalid422The registry secret was refused. The message says why; correct it and send it again.
template_locked409Corefinity has locked this template; the message says why. Contact Corefinity support to change it.
template_refused_on422Some of the environments chosen cannot be reset. Leave out the ones the answer lists, then reset the rest.
timeout_out_of_range422The timeout is outside what a stage may take. Choose a value in the range the message names.
too_many_secrets422The company already has the most registry secrets it can hold. Delete one first.
too_many_variables422The environment or company already has the most variables it can hold. Delete one first.
variable_invalid422The variable's name or value is not allowed. The message says which rule; correct it.
variable_reserved422The name is set by the platform. Choose another name.
variable_tool_credential422Builds see the variable under another name, so the tool it is meant for never reads it. Add the credentials under Deployments, Private registries, instead.
version_unavailable422The version is not available here. Read the versions on offer and choose one of them.

Deployments

11
ReasonStatusWhat it means and what to do
artifact_pruned409The deployment's archive was removed after 30 days, so it cannot be retried or rolled back. Deploy again from the branch or commit.
bedrock_layout409The WordPress site is built with Bedrock, so it cannot switch to manual deployments yet. Keep deploying it with Git.
deployment_running409A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again.
layout_unknown409The site's files are not laid out in a way the Control Panel could confirm, so nothing was read or changed. Read the message; try again in a minute.
mode409The site deploys another way than this needs, by upload where Git is needed or the reverse, or its files are not in the releases layout yet. Switch its deployment mode first.
needs_reauth409The repository's connection is gone or needs authorising again. Reconnect the repository.
no_repository422The site has no repository connected. Connect one first.
not_failed409Only a failed deployment can be retried. Deploy again instead.
pipeline_changed_since_build409The pipeline changed after this deployment was built. Deploy again instead of retrying.
pipeline_untranslated409The pipeline came from CoreStack Enterprise and has not been translated yet. Review it in the site's deployment settings first.
rollback_not_retryable409A rollback cannot be retried. Roll back again, or deploy.

Domains

9
ReasonStatusWhat it means and what to do
confirm_replacements422The change would replace DNS records that exist. Read which in the answer, then send confirm_replacements: true.
host_taken422Another site already uses the hostname. Remove it there first, or choose another.
maintenance409The site is in maintenance mode, which blocks this. Switch maintenance mode off first.
not_connected409The outside account this needs is not connected for your company. Connect it first; the message names it.
preview_only409The environment has no domain attached yet. Attach one first.
preview_token422The preview is missing or older than 15 minutes. Run the preview again and send its token.
store_required422This address needs a Magento store choice. Choose the Magento website or store view this address shows.
already_attached409The environment already has a domain. Change it under Domains instead.
too_many422Too many DNS records would change in one request. Point the hostnames in two steps.

Enterprise copies

16
ReasonStatusWhat it means and what to do
consumer_hold_off409Copies are paused for the moment. Try again later.
copy_ended409The copy has ended already. Start a new copy.
copy_exists409The target already has an unfinished copy. Finish or re-sync that one.
copy_not_latest409A newer copy of the site exists. Re-sync that one.
copy_running409The copy is still running. Wait for its run to end.
copy_unchecked409The copy's checks did not complete, so it cannot be finished. Re-sync it.
neutralise_off409Copies are paused for the moment. Try again later.
platform_mismatch409The site and the environment run different platforms. Copy into a site of the same platform.
source_moving409The environment has a move open, or has moved to CoreStack. Copy it once the move is settled, or copy from its new site.
source_unsupported409The environment cannot be copied as it is. Contact Corefinity support to find out why.
target_busy409The environment to copy or restore into is busy with another change. Nothing was changed. Wait, then try again.
target_crons_on409The site to copy into has its scheduled tasks on. Switch them off before copying into it.
target_live409The site to copy into has a domain attached, and a copy never overwrites a live site. Choose a site that is not live.
target_not_ready409The site to copy into is not ready to take a copy. Read the message: wait until it is ready, or choose another site.
target_too_small409The target does not have the space the copy or snapshot needs. Choose a larger size or a larger target.
target_unprotected409The site to copy into is not protected by HTTP authentication over the whole environment. Protect it first: copied data must never be public.

Enterprise deployments

5
ReasonStatusWhat it means and what to do
artifact_pruned409The deployment's archive was removed after 30 days, so it cannot be retried or rolled back. Deploy again from the branch or commit.
internal_error500The request could not be completed. Try again in a moment, and contact Corefinity support if it keeps failing.
no_namespace409The environment is not set up on its cluster yet. Contact support.
pipeline_changed_since_build409The pipeline changed after this deployment was built. Deploy again instead of retrying.
retry_from_step_unavailable422This deployment cannot be retried from the step that failed. Retry it from the start, or deploy again.

Environment variables

5
ReasonStatusWhat it means and what to do
exists409It already exists. Use the existing one.
too_many_variables422The environment or company already has the most variables it can hold. Delete one first.
variable_invalid422The variable's name or value is not allowed. The message says which rule; correct it.
variable_reserved422The name is set by the platform. Choose another name.
variable_tool_credential422Builds see the variable under another name, so the tool it is meant for never reads it. Add the credentials under Deployments, Private registries, instead.

Environments

10
ReasonStatusWhat it means and what to do
cleaning_up409The site, the environment or its last restore is still being cleaned up or removed. Try again in a few minutes.
duplicate409The same thing already exists here. Use the existing one, or choose another name or value.
site_unadopted409The site is not ready to be changed from the Control Panel yet. Contact Corefinity support.
tier_cluster_missing503The server type asked for is not available in this region yet. Contact Corefinity support.
billing_forbidden403Billing is for the organisation's owner and billing contacts. Ask one of them to do this.
contract_missing409There is no billing contract to price this against. Ask support to set up billing, or make the change without a quote where that is offered.
included_size409The included staging environment cannot be smaller than its included size. Choose that size or a larger one.
no_payment_method409There is no payment method on the account. Add a card or a Direct Debit mandate first.
snapshot_transfer422A saved snapshot can be copied only to an environment on the same servers for now. Copy the live environment instead, or restore the snapshot first.
source_busy409The environment to copy from is busy with another change, or is being deleted. Nothing was copied. Wait, then try again.

Error pages

7
ReasonStatusWhat it means and what to do
error_pages_locked422Corefinity has locked the environment's error pages. Contact support to change them.
invalid_page422An error page cannot be saved as it is. Fix the errors the answer lists.
operation_in_progress409A change to the environment is in progress. Try again when it has finished.
runtime_lacks_capability422The site's runtime does not support this yet. It is available after the site's platform update.
switch_reconcile_failed409The maintenance switch could not be checked on the site, so nothing was changed. Try again shortly.
tenant_mismatch422An object named in the request is not one of this site's or this company's. Check the ids and names.
too_large413What was sent is larger than the endpoint takes. The message names the limit; send less.

Feedback

2
ReasonStatusWhat it means and what to do
length_required411The request needs a Content-Length header. Send the body with its length.
payload_too_large413The request or an attachment is too large. Send less, or smaller files.

Firewall

13
ReasonStatusWhat it means and what to do
firewall_address_invalid422The address is not an IPv4 or IPv6 address or a range in CIDR form. Correct it, for example 203.0.113.0/24.
firewall_address_refused422The address is in a private, reserved or provider range. Use the public address the traffic comes from.
firewall_approval_required422Ranges wider than /24 (IPv6 /48) need approval from Corefinity. Send the range as a range request.
firewall_cap_exceeded422The list already holds the most addresses it can. Remove one first.
firewall_duplicate422The address is already on the list. Nothing needs adding.
firewall_not_editable403You can see the entry but may not change it. Ask the person or company that owns it.
firewall_preset_present422The preset is already attached here. Nothing needs adding.
firewall_scope_invalid422The scope cannot apply to this address here. Choose a scope the firewall's read lists for it.
firewall_scope_unavailable422Website access is not available for this environment. Use SSH or database access, or ask Corefinity support.
firewall_state_conflict409The entry changed since you read it. Read the firewall again and send the change again.
firewall_throttled429Too many firewall changes were sent. Wait a minute and try again.
firewall_width_refused422The range is too wide to allow. Send a narrower range.
not_found404The object does not exist, has expired, or is not yours to see. Check the id.

Laravel queues

5
ReasonStatusWhat it means and what to do
connect_failed503The site's cluster could not be reached. Try again in a minute.
deployment_running409A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again.
helper_failed502The site could not be read to answer this. Try again in a minute.
install_running409An installer is still running on the site. Contact support.
site_unadopted409The site is not ready to be changed from the Control Panel yet. Contact Corefinity support.

Logs

10
ReasonStatusWhat it means and what to do
download_preparing409The download is still being prepared. Read the export again in a few seconds.
expired410What was asked for has expired or been deleted. Prepare it again where that is possible.
line_not_found404The log line is no longer available. Search again.
logs_busy503Logs are busy. Try again in a few seconds.
logs_cluster_unavailable503Logs are not available at the moment. Try again shortly.
logs_not_collected409Logs are not being collected for the environment yet. Try again later, or contact support.
logs_range409The time range is outside the days logs are kept for. Choose a range inside the days the message names.
logs_unavailable409Logs could not be read, or are not collected for the site yet. Read the message; try again shortly.
query_too_wide409The search covers too much. Choose a shorter range or a narrower search.
logs_scope_split409The sites asked for keep their logs in different places. Ask for one CoreCluster or one site.

Magento stores

13
ReasonStatusWhat it means and what to do
not_magento404Only a Magento 2 site has Magento stores. Choose a Magento 2 site.
store_hosts409This site serves extra Magento stores on their own addresses. Ask Corefinity support to change its domains.
store_mapping_unreadable409The store mapping in this site's nginx rules has been edited by hand. Remove the edit in the Nginx tab, or ask Corefinity support.
stores_unreadable502Magento's stores could not be read. Try again in a moment.
domains_locked422The site's domains cannot be changed at the moment. Read the message: take the site live first, or wait for the change in progress.
nginx_invalid422The Nginx rules have errors and were not saved. Fix the errors the answer lists.
nginx_rules_locked422Corefinity has locked this environment's Nginx rules. Contact Corefinity support to change them.
nginx_rules_not_adopted422This site's nginx rules need a one-off update before a store can be mapped. Save them once in the Nginx tab.
store_code_format422Magento store codes with capital letters cannot be used for an address yet. Rename the code in Magento to lower case.
store_host_not_served422This address does not show its own store on this site yet. Add it as an alias that shows a store first.
store_inactive422The store view, or the website's default store view, is switched off in Magento. Switch it on first, or choose another.
store_mapping_foreign422Your nginx rules already set the Magento store outside the Control Panel's store mapping. Remove that from the Nginx tab first.
store_unknown422Magento has no website or store view with that code. Read the current stores and choose one of their codes.

Maintenance windows

5
ReasonStatusWhat it means and what to do
batch_applying409Maintenance is running on the site now. Try again when it finishes.
throttled429Too many tries. Wait a minute and try again.
window_locked409The maintenance window is set by Corefinity. Contact support to change it.
window_scope_unavailable422This has no maintenance window of its own. Set the window on its website or cluster.
window_start_invalid422The start hour is not one. Choose an hour from 00 to 23.

Node.js

7
ReasonStatusWhat it means and what to do
ack_required422The change has a warning that must be confirmed first. Send the acknowledgement the endpoint names, then send the change again.
connect_failed503The site's cluster could not be reached. Try again in a minute.
copy_target_invalid422Settings can be copied only to another environment of the same site. Choose one of the site's environments.
node_check_failed502The package check could not be read. Try again; contact Corefinity support if it keeps failing.
package_spec_invalid422A package is named by its npm registry name only. Remove the URL, git, file, link, alias or workspace form.
runtime_locked409Corefinity has locked this environment's configuration. Contact Corefinity support to change it.
scripts_memory422Install scripts need more command-line memory than the environment has. Choose a larger size, or leave install scripts off.

Operations

3
ReasonStatusWhat it means and what to do
already_revealed409The one-time login was already shown. Reset the password where the endpoint offers a reset.
cluster_paused409The site's CoreCluster is paused for planned maintenance. Any request that changes a site in it can answer this, on any endpoint, whether or not the endpoint's page lists it. Nothing was changed; try again later.
not_retryable422The operation cannot be retried this way. Read the message: make the change again, or do what it names instead.

Orders

1
ReasonStatusWhat it means and what to do
orders_forbidden403Orders are for the organisation's owner and people with a billing role. Ask one of them.

Outbound email

8
ReasonStatusWhat it means and what to do
duplicate409The same thing already exists here. Use the existing one, or choose another name or value.
limit409, 429A limit on how many of these there can be, or how often this can be done, has been reached. Read the message: remove or close one, or try again later.
no_zone409The site's domain is not in a connected Cloudflare zone, or Cloudflare is off for the site. Connect the Cloudflare account that holds the zone.
not_connected409The outside account this needs is not connected for your company. Connect it first; the message names it.
staff_managed409Corefinity staff manage this for the site. Contact support to change it.
state409, 422What the request acts on is not in a state that allows this. Read the message.
tenant_mismatch404An object named in the request is not one of this site's or this company's. Check the ids and names.
unavailable409This is not available for the site or environment, or not at the moment. Read the message; try again later where it says so, or contact support.

PHP

7
ReasonStatusWhat it means and what to do
ack_required422The change has a warning that must be confirmed first. Send the acknowledgement the endpoint names, then send the change again.
connect_failed503The site's cluster could not be reached. Try again in a minute.
copy_target_invalid422Settings can be copied only to another environment of the same site. Choose one of the site's environments.
ini_invalid422A php.ini line is not allowed. The message names the setting; remove or correct it.
layout_unknown409The site's files are not laid out in a way the Control Panel could confirm, so nothing was read or changed. Read the message; try again in a minute.
runtime_locked409Corefinity has locked this environment's configuration. Contact Corefinity support to change it.
already_adopted409The environment is already on the runtime. Nothing needs changing.

PHP settings

5
ReasonStatusWhat it means and what to do
connect_failed503The site's cluster could not be reached. Try again in a minute.
ini_invalid422A php.ini line is not allowed. The message names the setting; remove or correct it.
runtime_locked409Corefinity has locked this environment's configuration. Contact Corefinity support to change it.
runtime_not_adopted409The site or cluster does not run the runtime this needs yet. Read the message: leave the input out, or ask Corefinity support about the runtime update.
unavailable503This is not available for the site or environment, or not at the moment. Read the message; try again later where it says so, or contact support.

Packages and capacity

9
ReasonStatusWhat it means and what to do
addon_bounds422An add-on quantity is outside what is allowed. Choose a whole number inside the range the message gives.
auto_upgrades_unavailable409Automatic upgrades are not available for the organisation yet. Read the message, or contact support.
billing_forbidden403Billing is for the organisation's owner and billing contacts. Ask one of them to do this.
same_addons409These are already the add-ons. Change a quantity first.
same_family409This is already the server type. Choose a different one.
tier_cluster_missing503The server type asked for is not available in this region yet. Contact Corefinity support.
downgrade409A smaller package cannot be chosen here. Choose a larger one; downgrades are arranged with support.
package_unknown422That is not a package Corefinity sells for this. Choose one from the catalogue.
same_package409This is already the package. Choose a different one.

PageSpeed

2
ReasonStatusWhat it means and what to do
maintenance422The site is in maintenance mode, which blocks this. Switch maintenance mode off first.
preview_only409The environment has no domain attached yet. Attach one first.

Password protection

3
ReasonStatusWhat it means and what to do
legacy_hash409The login was carried over with a password that cannot be shown. Set a new password for it.
cluster_paused409The site's CoreCluster is paused for planned maintenance. Any request that changes a site in it can answer this, on any endpoint, whether or not the endpoint's page lists it. Nothing was changed; try again later.
legacy_adopt_pending409HTTP authentication is being prepared for the site and is not available yet. Try again later.

Pending changes

4
ReasonStatusWhat it means and what to do
batch_held409The queued changes are on hold. Wait, or ask Corefinity support why.
batch_window409The queued changes are being applied in the maintenance window. Wait for the window to finish.
item_state409The queued change is no longer in a state that allows this. Read the pending changes again.
nothing_pending409Nothing is queued to apply or cancel. Read the pending changes again.

Performance audits

5
ReasonStatusWhat it means and what to do
location_gone409The audit's server location no longer exists. Choose another location for the audit.
not_shared409The audit has no live share link. Share it first.
nothing_to_run409The audit has no domains or pages to test. Add them to the audit first.
run_in_progress409The audit is running. Wait for it to finish.
too_large409What was sent is larger than the endpoint takes. The message names the limit; send less.

Platform plugins

5
ReasonStatusWhat it means and what to do
connect_failed503The site's cluster could not be reached. Try again in a minute.
cut_over_unknown503Whether the site is past its go-live hold could not be confirmed, so nothing was changed. Try again in a minute.
runtime_lacks_capability409The site's runtime does not support this yet. It is available after the site's platform update.
site_cut_over409The site is past its go-live hold, so its platform plugins can no longer be turned off. Nothing to change.
unavailable503This is not available for the site or environment, or not at the moment. Read the message; try again later where it says so, or contact support.

Platform tools

2
ReasonStatusWhat it means and what to do
deployment_running409A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again.
install_running409An installer is still running on the site. Contact support.

Redirects

1
ReasonStatusWhat it means and what to do
cluster_paused409The site's CoreCluster is paused for planned maintenance. Any request that changes a site in it can answer this, on any endpoint, whether or not the endpoint's page lists it. Nothing was changed; try again later.

Registry secrets

2
ReasonStatusWhat it means and what to do
exists409It already exists. Use the existing one.
secret_invalid422The registry secret was refused. The message says why; correct it and send it again.

Repository connections

2
ReasonStatusWhat it means and what to do
connection_in_use409Environments still deploy with this repository connection. Choose another connection in each one's deployment settings first.
invalid_cursor422The cursor is not one the list gave. Start again from the first page.

SSH keys

13
ReasonStatusWhat it means and what to do
not_found404The object does not exist, has expired, or is not yours to see. Check the id.
ssh_cap_exceeded422There are too many keys here. Remove one you no longer need.
ssh_environment_unmanaged422SSH on this environment is not managed by the Control Panel. Contact support.
ssh_key_duplicate409The key is already added here. Use the existing one.
ssh_key_invalid422That is not an SSH public key Corefinity can use. Paste one OpenSSH public key.
ssh_key_weak422The key is too weak. Use an ed25519 key, or RSA of at least 3072 bits.
ssh_legacy_ended422The Legacy key has already stopped working. Add the key again as a new key.
ssh_managed_on_another_environment409This environment's SSH is managed on another environment. Make the change on the environment the answer names.
ssh_not_legacy422That is not a Legacy key. Change it as an ordinary key.
ssh_throttled429Too many SSH key changes or host key rotations were sent. Wait a minute and try again.
ssh_host_keys_unmanaged422Host keys on this environment are managed by Corefinity. Nothing to rotate here.
ssh_rotation_in_progress409A host-key rotation is already in progress. Wait for it to finish, or finish or cancel it.
ssh_rotation_unavailable422The environment cannot rotate its host keys now, or there is no staged rotation to finish or cancel. Read the host keys again.

Sites

10
ReasonStatusWhat it means and what to do
capacity_blocked409The cluster does not have room for this. Free some capacity, choose a smaller size, or move to a larger package.
clone_in_progress409Another copy is running on the site. Wait for it to finish.
cluster_deleting409The cluster is being deleted. Nothing can be changed on it.
cluster_paused409The site's CoreCluster is paused for planned maintenance. Any request that changes a site in it can answer this, on any endpoint, whether or not the endpoint's page lists it. Nothing was changed; try again later.
deletion_in_progress409The site is still being deleted. Try again once it shows as deleted.
has_environments409The site still has an environment that stops this. Read the message: delete its other environments first, or do what it names.
not_restorable409A deleted environment cannot be restored: environments are removed at once. Recreate it from its final snapshot.
not_acknowledged404The attention item has no acknowledgement to withdraw. Nothing needs doing.
not_open404The attention item is no longer open. Read the list again.
is_production409The production environment is the site itself. Delete the site instead.

Snapshots

13
ReasonStatusWhat it means and what to do
disabled422Snapshots are not enabled for the site or its cluster. Contact support to have them turned on.
google_cap429The hourly snapshot limit was reached. Try again later.
in_flight409A snapshot is already being taken. Wait for it.
manual_cap429The hourly limit of one-off snapshots for the environment was reached. Try again later.
mariadb_change409The database version is changing, or the snapshot's database version does not fit the environment. Read the message: wait for the change to finish, or restore into a new environment.
not_healthy409The site is not running normally. Wait until it is, or contact support.
platform_cluster409The cluster is the CoreStack platform, which has no settings or sites of its own to change this way. Change or create the site itself instead.
restoring409A restore is running. Wait for it to finish.
setting_up409The site was created moments ago and its storage is not ready yet. Try again in a few minutes.
settling409The database started moments ago and is still settling. Try again in a few minutes.
state409, 422, 502, 503What the request acts on is not in a state that allows this. Read the message.
unreadable502The site's state could not be read. Try again shortly.
keep_cap_reached422Kept snapshots already use the most space allowed. Stop keeping another snapshot first.

Support

3
ReasonStatusWhat it means and what to do
already_received409The upload already has its file. Create a new upload for another file.
invalid_signature403The upload address has changed or expired. Create a new upload.
state422What the request acts on is not in a state that allows this. Read the message.

Team

9
ReasonStatusWhat it means and what to do
already_active403The person is already active. There is no invitation to send again.
in_use409It is still in use, still being removed, or managed somewhere else. Read the message: wait for the removal, remove what uses it first, or remove it where the message says.
invite_company_gone409The organisation the person was invited to no longer exists or is not active. Invite them again from an active organisation.
last_owner403The organisation must keep at least one owner. Make someone else an owner first.
not_connected409The outside account this needs is not connected for your company. Connect it first; the message names it.
only_user403This is the only user in the organisation. Add another user first.
owner_grant403Only an owner or Corefinity staff can make someone an owner. Ask an owner.
permission_grant403You can give someone a role only if you hold all of its permissions yourself. Ask someone who holds them.
privileged_target403That person's account can be changed only by Corefinity. Contact support.

Terminal

1
ReasonStatusWhat it means and what to do
expired410What was asked for has expired or been deleted. Prepare it again where that is possible.

Variables and secrets

6
ReasonStatusWhat it means and what to do
exists409It already exists. Use the existing one.
secret_invalid422The registry secret was refused. The message says why; correct it and send it again.
too_many_variables422The environment or company already has the most variables it can hold. Delete one first.
variable_invalid422The variable's name or value is not allowed. The message says which rule; correct it.
variable_reserved422The name is set by the platform. Choose another name.
variable_tool_credential422Builds see the variable under another name, so the tool it is meant for never reads it. Add the credentials under Deployments, Private registries, instead.

Varnish

15
ReasonStatusWhat it means and what to do
ack_required422The change has a warning that must be confirmed first. Send the acknowledgement the endpoint names, then send the change again.
host_not_owned422A URL names a host that is not one of the site's. Purge only the site's own hosts.
image_not_offered409The version the change needs is not available at the moment. Nothing was changed; try again later.
invalid_tags422A cache tag is not one. Send tags as the site sets them.
memory_split409Corefinity staff have divided the environment's memory between its services by hand, and this change would undo that. Ask support to make the change.
unchanged409Nothing would change. Nothing to do.
varnish_not_offered409, 422Varnish is available for Magento 2 sites only. Nothing to change here.
varnish_off409, 422Varnish is off on the environment. Switch it on first.
varnish_too_small422Varnish needs more memory than the package's cache share gives it. Choose a larger package, or switch RabbitMQ off.
vcl_check_unavailable503The VCL could not be checked against the Varnish version. Try again in a minute.
vcl_incompatible422Your VCL does not compile on that Varnish version. Change the VCL first, or keep the version.
version_unsupported422That Varnish version is not offered, or not available yet. Choose another version.
not_found404The object does not exist, has expired, or is not yours to see. Check the id.
vcl_invalid422The VCL breaks a rule of the platform. Nothing was saved. Fix what the message names.
vcl_locked422Corefinity manages this environment's VCL. Contact support to change it.

Web server rules

9
ReasonStatusWhat it means and what to do
apply_not_supported422The change applies at once and cannot wait for a window. Send it without apply, or with apply: now.
files_missing409The files the Control Panel manages for this are missing or not ready yet. Read the message: try again in a few minutes, keep the Control Panel's version, or contact support.
inventory_behind409The files changed again after they were read. Read them again, then choose again.
nginx_invalid422The Nginx rules have errors and were not saved. Fix the errors the answer lists.
nginx_rules_locked422Corefinity has locked this environment's Nginx rules. Contact Corefinity support to change them.
no_drift422The files are the ones the Control Panel last committed: there is no change made outside it to answer. Nothing to do.
not_admitted422The change cannot wait for tonight's window. Send it with apply: now.
not_found404The object does not exist, has expired, or is not yours to see. Check the id.
too_large413What was sent is larger than the endpoint takes. The message names the limit; send less.

Websites and environments

3
ReasonStatusWhat it means and what to do
billing_forbidden403Billing is for the organisation's owner and billing contacts. Ask one of them to do this.
confirm_cost422The change costs more each month. Send confirm_cost: true once the cost in the message is agreed.
warning_not_acknowledged422The chosen size carries a warning. Send the acknowledgement the message names to keep it, or choose a larger size.

Handling refusals in code

RuleReason
Branch on reasonMessages can be reworded
Retry 429 and 502 after a waitThey are temporary. A 502's message says so when part of the change was made
Retry a 503 after a wait only when its reason says nothing was startedswitched_off, temporarily_unavailable and the like are safe. Where a reason's sentence above says the work may have run, check first and never send it again automatically
Do not retry 409 blindWait for the state to change, or read again first
Never retry 401, 403, 404 or 422 unchangedThe same request gets the same answer

Each endpoint's reference page lists the reasons it can give.

Was this helpful?
Open in ClaudeOpen in ChatGPT