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.
{
"message": "Another change to this environment is not finished yet.",
"reason": "operation_in_progress",
"code": "operation_in_progress"
}
Statuses
| Status | Meaning | reason |
|---|
401 | No token, or a token that is not valid | None |
403 | The token lacks a scope, two-factor authentication is not set up, or the person may not use this | scope_required, two_factor_required, company_not_enabled, or none |
404 | Not found or not yours to see, or the feature is off | None, feature_off, or a named reason |
409 | The request is fine but the current state refuses it | Nearly always |
422 | A field is missing or wrong, or a rule refuses the request | invalid, confirm_mismatch or a named reason |
429 | Too many requests | rate_limited, or the name of a limit of the endpoint's own |
502 | Something the request depends on could not be reached | None, or a reason such as upstream_unavailable |
503 | The action is switched off, or cannot be served, for the moment | switched_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.
| Where | reason | detail_reason |
|---|
A database user's confirm_read_write that is typed and does not match | invalid | confirm_mismatch |
{
"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.
{
"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
| Status | reason | What to do |
|---|
403 | scope_required | Use a token with the scope in scope; see Scopes |
403 | two_factor_required | Set up two-factor authentication; see Two-factor authentication |
403 | company_not_enabled | Your account has no company that can use Managed Clusters, for example because the company was closed. Ask Corefinity support |
403 | company_unavailable | Your account belongs to no company, or to a deleted one. Ask Corefinity support |
403 | pending_order | Your company's first order is not finished. Finish it in the Control Panel, at the address in redirect |
404 | None, "Not found." | Check the id; see Identifiers |
404 | feature_off | The feature is not on for your company |
409 | managed_elsewhere | The site is managed by another control panel. Change it there |
409 | busy | Another change to the site is running. Wait for its operation to finish |
409 | stale | What you read has changed. Read it again and send the change with the new version |
422 | invalid, invalid_arguments | Correct the fields named in errors |
422 | confirm_mismatch | Send the confirmation named in field exactly as the endpoint describes it |
429 | rate_limited | Wait for Retry-After seconds, which retry_after_seconds repeats; see Rate limits |
503 | switched_off | Corefinity 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.
Several areas
27
| Reason | Status | What it means and what to do |
|---|
busy | 409, 503 | Another change or command is running on what the request acts on. Wait for it to finish, then try again. |
command_running | 409 | Another action or command is still running on the site. Wait for it to finish, then try again. |
company_not_enabled | 403 | Your account has no company that can use Managed Clusters, for example because the company was closed. Ask Corefinity support. |
company_unavailable | 403 | Your company cannot be used at the moment. Ask Corefinity support. |
confirm | 422 | The action needs an explicit confirmation field. Ask the person, then send it. |
confirm_mismatch | 409, 422 | A 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. |
conflict | 409 | The 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. |
deleted | 409 | 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. |
exec_unresolved | 409 | An earlier command on the site has not been confirmed stopped. Contact support. |
feature_off | 404, 422 | The feature, or the input that needs it, is not switched on. Leave that input out, or ask Corefinity about the feature. |
forbidden | 403 | The 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. |
invalid | 422 | A field is missing or wrong. Correct the fields named in errors. |
invalid_arguments | 422 | A field is missing or wrong. Correct the fields named in errors; treat it as invalid. |
managed_elsewhere | 409 | The site is managed by another control panel. Make the change there. |
not_available | 409, 422 | The request does not apply to this object as it is. The message says why. |
not_running | 409 | 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. |
provisioning | 409 | The site is still being created. Try again in a few minutes. |
rate_limited | 429 | Too many requests. Wait for the seconds in Retry-After, which retry_after_seconds repeats, then try again. |
removed | 409 | The site or environment is being removed, or has been. Nothing can be changed on it. |
restore_running | 409 | A restore is running on the site. Wait for it to finish, then try again. |
scope_required | 403 | The token lacks the scope in scope. Use a token that holds it; see Scopes. |
stale | 409, 422 | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
switched_off | 503 | Corefinity has switched this kind of action off for the moment. Nothing was changed; try again later. |
temporarily_unavailable | 422, 503 | The request is fine but cannot be served at the moment. Nothing was started; try again in a minute. |
two_factor_required | 403 | Your company requires two-factor authentication and you have not set it up. Set it up on your profile; see Two-factor authentication. |
upstream_unavailable | 409, 502, 503 | A service the request depends on did not answer. Nothing was changed; try again in a minute. |
wrong_platform | 404, 409, 422 | This is not available for the site's platform. Use it on a site of the platform it is for. |
Access
5
| Reason | Status | What it means and what to do |
|---|
in_use | 409 | It 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. |
restricted | 403 | Restricted keys are changed by Corefinity staff only. Ask Corefinity support. |
ssh_key_duplicate | 409 | The key is already added here. Use the existing one. |
ssh_person_managed_elsewhere | 422 | That username belongs to a person's own SSH login, managed in their profile. Choose another name. |
ssh_throttled | 429 | Too many SSH key changes or host key rotations were sent. Wait a minute and try again. |
Account security
2
| Reason | Status | What it means and what to do |
|---|
confirmation_required | 409 | Staying signed in longer needs you to confirm it is you. Confirm it in the Control Panel, then try again. |
trust_above_session_limit | 422 | A 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
| Reason | Status | What it means and what to do |
|---|
catalogue_unavailable | 503 | The list of versions could not be read. Nothing was changed; try again in a minute. |
Billing
14
| Reason | Status | What it means and what to do |
|---|
billing_forbidden | 403 | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
billing_settling | 409 | The environment has been moved and its billing is still being updated. Try again in a few minutes. |
contract_missing | 409 | There 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_ready | 404 | The credit note is not ready yet. Try again shortly. |
currency_unpublished | 422 | Prices in that currency are not available right now. Choose another currency, or try again later. |
downgrade | 409 | A smaller package cannot be chosen here. Choose a larger one; downgrades are arranged with support. |
link_expired | 410 | The link has expired. Create a new link and download again. |
package_unknown | 422 | That is not a package Corefinity sells for this. Choose one from the catalogue. |
pdf_missing | 404 | The invoice's PDF could not be found. Open a support ticket and Corefinity will send it. |
pdf_pending | 409 | The invoice's PDF is not ready yet. Try again in a few minutes. |
provider_unavailable | 503 | The payment provider, or the old host, did not answer. Try again later. |
same_family | 409 | This is already the server type. Choose a different one. |
same_package | 409 | This is already the package. Choose a different one. |
zone_unknown | 422 | That is not a region. Choose uk, us, nl or aus. |
Cloudflare
6
| Reason | Status | What it means and what to do |
|---|
no_zone | 409 | The 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_connected | 409, 422 | The outside account this needs is not connected for your company. Connect it first; the message names it. |
not_owner | 409 | The Cloudflare rule belongs to another change, so it was left as it is. Wait for that change to finish. |
rule_edited | 409 | The 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_allowed | 422 | The Cloudflare token may not change the zone's rules. Allow Zone, Config Rules, Edit on the token, or connect one that can. |
unavailable | 502 | This 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
| Reason | Status | What it means and what to do |
|---|
clone_in_progress | 409 | Another copy is running on the site. Wait for it to finish. |
copy_limit | 429 | Your company already has the most copies or restores it can run at once. Try again when one has finished. |
copy_queued | 409 | A copy onto this environment already waits its turn. Cancel it first to queue another. |
different_cluster | 409 | A copy works within one cluster, and the target is in another. Choose a target in the same cluster. |
legacy_search | 422 | The site's search runs on an older engine kept for the move. Switch the store to the OpenSearch module first. |
maintenance | 409 | The site is in maintenance mode, which blocks this. Switch maintenance mode off first. |
not_waiting | 409 | The copy is no longer waiting, so it cannot be cancelled. Follow its operation instead. |
snapshot_transfer | 422 | A 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_unreachable | 409 | The environment to copy from cannot be reached. Try again in a few minutes. |
target_busy | 409 | The environment to copy or restore into is busy with another change. Nothing was changed. Wait, then try again. |
too_small | 409 | The target is too small for what it would hold. Choose a larger size. |
CoreCluster
9
| Reason | Status | What it means and what to do |
|---|
cluster_busy | 409 | Another change to the cluster is running. Wait for it to finish, then try again. |
cluster_deleting | 409 | The cluster is being deleted. Nothing can be changed on it. |
cluster_not_empty | 409 | The 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_blocked | 409 | There is no server capacity for this size at the moment. Choose another size, or contact support. |
duplicate | 409 | The same thing already exists here. Use the existing one, or choose another name or value. |
legacy_cluster | 409 | Corefinity manages this cluster. Contact support to change its package or delete it. |
region_unavailable | 409 | The region has no room for this at the moment. Choose another region, or try again later. |
runtime_not_adopted | 422 | The 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_removal | 409 | The cluster holds something only Corefinity can remove. Contact support to delete it. |
Create a site
10
| Reason | Status | What it means and what to do |
|---|
billing_forbidden | 403 | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
catalogue_unavailable | 503 | The list of versions could not be read. Nothing was changed; try again in a minute. |
cleaning_up | 409 | The site, the environment or its last restore is still being cleaned up or removed. Try again in a few minutes. |
commerce_check_unavailable | 503 | The Marketplace keys could not be checked. Try again in a few minutes. |
duplicate | 409 | The same thing already exists here. Use the existing one, or choose another name or value. |
no_payment_method | 409 | There is no payment method on the account. Add a card or a Direct Debit mandate first. |
no_platform_cluster | 409 | The region has no CoreStack platform yet. Choose another region. |
already_revealed | 409 | The one-time login was already shown. Reset the password where the endpoint offers a reset. |
placement | 409 | The CoreCluster cannot take a site of this platform yet. Choose another placement, or ask Corefinity support. |
platform_cluster | 409 | The 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
| Reason | Status | What it means and what to do |
|---|
external_off | 422 | External access is off, and external users connect through it. Turn external access on first. |
reveal_gone | 410 | The password can no longer be shown. Rotate it to get a new one. |
unchanged | 422 | Nothing would change. Nothing to do. |
user_cap | 422 | The environment holds as many database users as it can. Delete one you no longer need, or ask support. |
user_not_found | 404 | There is no such database user on the environment. Read the users again. |
billing_forbidden | 403 | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
change_pending | 409 | A change is already queued for tonight. Apply it now or cancel it first. |
demo_keep_required | 409 | Creating CoreStack sites needs the demo to be kept first. Keep your demo, then try again. |
external_db_already_off | 409 | External access is already off. Nothing to do. |
external_db_already_on | 409 | External access is already on. Nothing to do. |
external_db_failed | 409 | External access could not be turned on. Contact support so it can be finished or undone. |
external_db_not_available | 422 | External access is not available on the environment yet. Ask support. |
external_db_not_on | 409 | External access is off. Turn it on first. |
external_db_unchanged | 409 | The allowed addresses are already exactly these. Nothing to do. |
restart_batches_off | 409 | Changes cannot be queued for the maintenance window at the moment. Apply the change now instead. |
Demos
10
| Reason | Status | What it means and what to do |
|---|
addon_bounds | 422 | An add-on quantity is outside what is allowed. Choose a whole number inside the range the message gives. |
already_kept | 409 | The demo has already been kept. Nothing to do. |
billing_details_required | 409 | Billing details are needed to keep the demo. Add them, then keep it. |
demo_building | 409 | The demo is still being set up. Keep it once it is ready. |
demo_closed | 409 | The demo has ended and can no longer be kept. Start an order to carry on. |
forbidden_role | 403 | Keeping a demo needs the organisation's owner or a billing role. Ask the owner to keep it. |
package_not_offered | 422 | The package chosen for the demo is not offered. Choose one that is. |
package_platform | 422 | The package is not offered for the site's platform. Choose a package that is. |
payment_method_required | 409 | A payment method is needed to keep the demo. Add one, then keep it. |
privacy_required | 422 | The privacy notice has not been accepted. Accept it to keep the demo. |
Deployment pipeline
8
| Reason | Status | What it means and what to do |
|---|
deployment_running | 409 | A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again. |
line_credentials | 422 | A pipeline line holds a credential. Move the value into a variable, then save again. |
maintenance_policy_unavailable | 422 | The platform has no pending-upgrade check, so that maintenance policy cannot be chosen. Choose Always or Off. |
pipeline_classic | 409 | Corefinity still runs this pipeline in its classic form, so it cannot be edited yet. Contact Corefinity support. |
pipeline_locked | 409 | Corefinity has locked this pipeline; the message says why. Contact Corefinity support to change it. |
rehearsal_production | 409 | A rehearsal never runs on production. Rehearse on a staging environment of the site. |
timeout_out_of_range | 422 | The timeout is outside what a stage may take. Choose a value in the range the message names. |
version_unavailable | 422 | The version is not available here. Read the versions on offer and choose one of them. |
Deployment templates
12
| Reason | Status | What it means and what to do |
|---|
exists | 409 | It already exists. Use the existing one. |
reach_changed | 409 | The environments the change reaches have changed since you reviewed it. Read them again, then confirm. |
secret_invalid | 422 | The registry secret was refused. The message says why; correct it and send it again. |
template_locked | 409 | Corefinity has locked this template; the message says why. Contact Corefinity support to change it. |
template_refused_on | 422 | Some of the environments chosen cannot be reset. Leave out the ones the answer lists, then reset the rest. |
timeout_out_of_range | 422 | The timeout is outside what a stage may take. Choose a value in the range the message names. |
too_many_secrets | 422 | The company already has the most registry secrets it can hold. Delete one first. |
too_many_variables | 422 | The environment or company already has the most variables it can hold. Delete one first. |
variable_invalid | 422 | The variable's name or value is not allowed. The message says which rule; correct it. |
variable_reserved | 422 | The name is set by the platform. Choose another name. |
variable_tool_credential | 422 | Builds 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_unavailable | 422 | The version is not available here. Read the versions on offer and choose one of them. |
Deployments
11
| Reason | Status | What it means and what to do |
|---|
artifact_pruned | 409 | The deployment's archive was removed after 30 days, so it cannot be retried or rolled back. Deploy again from the branch or commit. |
bedrock_layout | 409 | The WordPress site is built with Bedrock, so it cannot switch to manual deployments yet. Keep deploying it with Git. |
deployment_running | 409 | A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again. |
layout_unknown | 409 | The 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. |
mode | 409 | The 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_reauth | 409 | The repository's connection is gone or needs authorising again. Reconnect the repository. |
no_repository | 422 | The site has no repository connected. Connect one first. |
not_failed | 409 | Only a failed deployment can be retried. Deploy again instead. |
pipeline_changed_since_build | 409 | The pipeline changed after this deployment was built. Deploy again instead of retrying. |
pipeline_untranslated | 409 | The pipeline came from CoreStack Enterprise and has not been translated yet. Review it in the site's deployment settings first. |
rollback_not_retryable | 409 | A rollback cannot be retried. Roll back again, or deploy. |
Domains
9
| Reason | Status | What it means and what to do |
|---|
confirm_replacements | 422 | The change would replace DNS records that exist. Read which in the answer, then send confirm_replacements: true. |
host_taken | 422 | Another site already uses the hostname. Remove it there first, or choose another. |
maintenance | 409 | The site is in maintenance mode, which blocks this. Switch maintenance mode off first. |
not_connected | 409 | The outside account this needs is not connected for your company. Connect it first; the message names it. |
preview_only | 409 | The environment has no domain attached yet. Attach one first. |
preview_token | 422 | The preview is missing or older than 15 minutes. Run the preview again and send its token. |
store_required | 422 | This address needs a Magento store choice. Choose the Magento website or store view this address shows. |
already_attached | 409 | The environment already has a domain. Change it under Domains instead. |
too_many | 422 | Too many DNS records would change in one request. Point the hostnames in two steps. |
Enterprise copies
16
| Reason | Status | What it means and what to do |
|---|
consumer_hold_off | 409 | Copies are paused for the moment. Try again later. |
copy_ended | 409 | The copy has ended already. Start a new copy. |
copy_exists | 409 | The target already has an unfinished copy. Finish or re-sync that one. |
copy_not_latest | 409 | A newer copy of the site exists. Re-sync that one. |
copy_running | 409 | The copy is still running. Wait for its run to end. |
copy_unchecked | 409 | The copy's checks did not complete, so it cannot be finished. Re-sync it. |
neutralise_off | 409 | Copies are paused for the moment. Try again later. |
platform_mismatch | 409 | The site and the environment run different platforms. Copy into a site of the same platform. |
source_moving | 409 | The environment has a move open, or has moved to CoreStack. Copy it once the move is settled, or copy from its new site. |
source_unsupported | 409 | The environment cannot be copied as it is. Contact Corefinity support to find out why. |
target_busy | 409 | The environment to copy or restore into is busy with another change. Nothing was changed. Wait, then try again. |
target_crons_on | 409 | The site to copy into has its scheduled tasks on. Switch them off before copying into it. |
target_live | 409 | The 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_ready | 409 | The 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_small | 409 | The target does not have the space the copy or snapshot needs. Choose a larger size or a larger target. |
target_unprotected | 409 | The 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
| Reason | Status | What it means and what to do |
|---|
artifact_pruned | 409 | The deployment's archive was removed after 30 days, so it cannot be retried or rolled back. Deploy again from the branch or commit. |
internal_error | 500 | The request could not be completed. Try again in a moment, and contact Corefinity support if it keeps failing. |
no_namespace | 409 | The environment is not set up on its cluster yet. Contact support. |
pipeline_changed_since_build | 409 | The pipeline changed after this deployment was built. Deploy again instead of retrying. |
retry_from_step_unavailable | 422 | This deployment cannot be retried from the step that failed. Retry it from the start, or deploy again. |
Environment variables
5
| Reason | Status | What it means and what to do |
|---|
exists | 409 | It already exists. Use the existing one. |
too_many_variables | 422 | The environment or company already has the most variables it can hold. Delete one first. |
variable_invalid | 422 | The variable's name or value is not allowed. The message says which rule; correct it. |
variable_reserved | 422 | The name is set by the platform. Choose another name. |
variable_tool_credential | 422 | Builds 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
| Reason | Status | What it means and what to do |
|---|
cleaning_up | 409 | The site, the environment or its last restore is still being cleaned up or removed. Try again in a few minutes. |
duplicate | 409 | The same thing already exists here. Use the existing one, or choose another name or value. |
site_unadopted | 409 | The site is not ready to be changed from the Control Panel yet. Contact Corefinity support. |
tier_cluster_missing | 503 | The server type asked for is not available in this region yet. Contact Corefinity support. |
billing_forbidden | 403 | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
contract_missing | 409 | There 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_size | 409 | The included staging environment cannot be smaller than its included size. Choose that size or a larger one. |
no_payment_method | 409 | There is no payment method on the account. Add a card or a Direct Debit mandate first. |
snapshot_transfer | 422 | A 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_busy | 409 | The environment to copy from is busy with another change, or is being deleted. Nothing was copied. Wait, then try again. |
Error pages
7
| Reason | Status | What it means and what to do |
|---|
error_pages_locked | 422 | Corefinity has locked the environment's error pages. Contact support to change them. |
invalid_page | 422 | An error page cannot be saved as it is. Fix the errors the answer lists. |
operation_in_progress | 409 | A change to the environment is in progress. Try again when it has finished. |
runtime_lacks_capability | 422 | The site's runtime does not support this yet. It is available after the site's platform update. |
switch_reconcile_failed | 409 | The maintenance switch could not be checked on the site, so nothing was changed. Try again shortly. |
tenant_mismatch | 422 | An object named in the request is not one of this site's or this company's. Check the ids and names. |
too_large | 413 | What was sent is larger than the endpoint takes. The message names the limit; send less. |
Feedback
2
| Reason | Status | What it means and what to do |
|---|
length_required | 411 | The request needs a Content-Length header. Send the body with its length. |
payload_too_large | 413 | The request or an attachment is too large. Send less, or smaller files. |
Firewall
13
| Reason | Status | What it means and what to do |
|---|
firewall_address_invalid | 422 | The 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_refused | 422 | The address is in a private, reserved or provider range. Use the public address the traffic comes from. |
firewall_approval_required | 422 | Ranges wider than /24 (IPv6 /48) need approval from Corefinity. Send the range as a range request. |
firewall_cap_exceeded | 422 | The list already holds the most addresses it can. Remove one first. |
firewall_duplicate | 422 | The address is already on the list. Nothing needs adding. |
firewall_not_editable | 403 | You can see the entry but may not change it. Ask the person or company that owns it. |
firewall_preset_present | 422 | The preset is already attached here. Nothing needs adding. |
firewall_scope_invalid | 422 | The scope cannot apply to this address here. Choose a scope the firewall's read lists for it. |
firewall_scope_unavailable | 422 | Website access is not available for this environment. Use SSH or database access, or ask Corefinity support. |
firewall_state_conflict | 409 | The entry changed since you read it. Read the firewall again and send the change again. |
firewall_throttled | 429 | Too many firewall changes were sent. Wait a minute and try again. |
firewall_width_refused | 422 | The range is too wide to allow. Send a narrower range. |
not_found | 404 | The object does not exist, has expired, or is not yours to see. Check the id. |
Laravel queues
5
| Reason | Status | What it means and what to do |
|---|
connect_failed | 503 | The site's cluster could not be reached. Try again in a minute. |
deployment_running | 409 | A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again. |
helper_failed | 502 | The site could not be read to answer this. Try again in a minute. |
install_running | 409 | An installer is still running on the site. Contact support. |
site_unadopted | 409 | The site is not ready to be changed from the Control Panel yet. Contact Corefinity support. |
Logs
10
| Reason | Status | What it means and what to do |
|---|
download_preparing | 409 | The download is still being prepared. Read the export again in a few seconds. |
expired | 410 | What was asked for has expired or been deleted. Prepare it again where that is possible. |
line_not_found | 404 | The log line is no longer available. Search again. |
logs_busy | 503 | Logs are busy. Try again in a few seconds. |
logs_cluster_unavailable | 503 | Logs are not available at the moment. Try again shortly. |
logs_not_collected | 409 | Logs are not being collected for the environment yet. Try again later, or contact support. |
logs_range | 409 | The time range is outside the days logs are kept for. Choose a range inside the days the message names. |
logs_unavailable | 409 | Logs could not be read, or are not collected for the site yet. Read the message; try again shortly. |
query_too_wide | 409 | The search covers too much. Choose a shorter range or a narrower search. |
logs_scope_split | 409 | The sites asked for keep their logs in different places. Ask for one CoreCluster or one site. |
Magento stores
13
| Reason | Status | What it means and what to do |
|---|
not_magento | 404 | Only a Magento 2 site has Magento stores. Choose a Magento 2 site. |
store_hosts | 409 | This site serves extra Magento stores on their own addresses. Ask Corefinity support to change its domains. |
store_mapping_unreadable | 409 | The 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_unreadable | 502 | Magento's stores could not be read. Try again in a moment. |
domains_locked | 422 | The 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_invalid | 422 | The Nginx rules have errors and were not saved. Fix the errors the answer lists. |
nginx_rules_locked | 422 | Corefinity has locked this environment's Nginx rules. Contact Corefinity support to change them. |
nginx_rules_not_adopted | 422 | This site's nginx rules need a one-off update before a store can be mapped. Save them once in the Nginx tab. |
store_code_format | 422 | Magento store codes with capital letters cannot be used for an address yet. Rename the code in Magento to lower case. |
store_host_not_served | 422 | This address does not show its own store on this site yet. Add it as an alias that shows a store first. |
store_inactive | 422 | The store view, or the website's default store view, is switched off in Magento. Switch it on first, or choose another. |
store_mapping_foreign | 422 | Your nginx rules already set the Magento store outside the Control Panel's store mapping. Remove that from the Nginx tab first. |
store_unknown | 422 | Magento has no website or store view with that code. Read the current stores and choose one of their codes. |
Maintenance windows
5
| Reason | Status | What it means and what to do |
|---|
batch_applying | 409 | Maintenance is running on the site now. Try again when it finishes. |
throttled | 429 | Too many tries. Wait a minute and try again. |
window_locked | 409 | The maintenance window is set by Corefinity. Contact support to change it. |
window_scope_unavailable | 422 | This has no maintenance window of its own. Set the window on its website or cluster. |
window_start_invalid | 422 | The start hour is not one. Choose an hour from 00 to 23. |
Node.js
7
| Reason | Status | What it means and what to do |
|---|
ack_required | 422 | The change has a warning that must be confirmed first. Send the acknowledgement the endpoint names, then send the change again. |
connect_failed | 503 | The site's cluster could not be reached. Try again in a minute. |
copy_target_invalid | 422 | Settings can be copied only to another environment of the same site. Choose one of the site's environments. |
node_check_failed | 502 | The package check could not be read. Try again; contact Corefinity support if it keeps failing. |
package_spec_invalid | 422 | A package is named by its npm registry name only. Remove the URL, git, file, link, alias or workspace form. |
runtime_locked | 409 | Corefinity has locked this environment's configuration. Contact Corefinity support to change it. |
scripts_memory | 422 | Install scripts need more command-line memory than the environment has. Choose a larger size, or leave install scripts off. |
Operations
3
| Reason | Status | What it means and what to do |
|---|
already_revealed | 409 | The one-time login was already shown. Reset the password where the endpoint offers a reset. |
cluster_paused | 409 | The 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_retryable | 422 | The operation cannot be retried this way. Read the message: make the change again, or do what it names instead. |
Orders
1
| Reason | Status | What it means and what to do |
|---|
orders_forbidden | 403 | Orders are for the organisation's owner and people with a billing role. Ask one of them. |
Outbound email
8
| Reason | Status | What it means and what to do |
|---|
duplicate | 409 | The same thing already exists here. Use the existing one, or choose another name or value. |
limit | 409, 429 | A 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_zone | 409 | The 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_connected | 409 | The outside account this needs is not connected for your company. Connect it first; the message names it. |
staff_managed | 409 | Corefinity staff manage this for the site. Contact support to change it. |
state | 409, 422 | What the request acts on is not in a state that allows this. Read the message. |
tenant_mismatch | 404 | An object named in the request is not one of this site's or this company's. Check the ids and names. |
unavailable | 409 | This 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
| Reason | Status | What it means and what to do |
|---|
ack_required | 422 | The change has a warning that must be confirmed first. Send the acknowledgement the endpoint names, then send the change again. |
connect_failed | 503 | The site's cluster could not be reached. Try again in a minute. |
copy_target_invalid | 422 | Settings can be copied only to another environment of the same site. Choose one of the site's environments. |
ini_invalid | 422 | A php.ini line is not allowed. The message names the setting; remove or correct it. |
layout_unknown | 409 | The 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_locked | 409 | Corefinity has locked this environment's configuration. Contact Corefinity support to change it. |
already_adopted | 409 | The environment is already on the runtime. Nothing needs changing. |
PHP settings
5
| Reason | Status | What it means and what to do |
|---|
connect_failed | 503 | The site's cluster could not be reached. Try again in a minute. |
ini_invalid | 422 | A php.ini line is not allowed. The message names the setting; remove or correct it. |
runtime_locked | 409 | Corefinity has locked this environment's configuration. Contact Corefinity support to change it. |
runtime_not_adopted | 409 | The 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. |
unavailable | 503 | This 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
| Reason | Status | What it means and what to do |
|---|
addon_bounds | 422 | An add-on quantity is outside what is allowed. Choose a whole number inside the range the message gives. |
auto_upgrades_unavailable | 409 | Automatic upgrades are not available for the organisation yet. Read the message, or contact support. |
billing_forbidden | 403 | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
same_addons | 409 | These are already the add-ons. Change a quantity first. |
same_family | 409 | This is already the server type. Choose a different one. |
tier_cluster_missing | 503 | The server type asked for is not available in this region yet. Contact Corefinity support. |
downgrade | 409 | A smaller package cannot be chosen here. Choose a larger one; downgrades are arranged with support. |
package_unknown | 422 | That is not a package Corefinity sells for this. Choose one from the catalogue. |
same_package | 409 | This is already the package. Choose a different one. |
PageSpeed
2
| Reason | Status | What it means and what to do |
|---|
maintenance | 422 | The site is in maintenance mode, which blocks this. Switch maintenance mode off first. |
preview_only | 409 | The environment has no domain attached yet. Attach one first. |
Password protection
3
| Reason | Status | What it means and what to do |
|---|
legacy_hash | 409 | The login was carried over with a password that cannot be shown. Set a new password for it. |
cluster_paused | 409 | The 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_pending | 409 | HTTP authentication is being prepared for the site and is not available yet. Try again later. |
Pending changes
4
| Reason | Status | What it means and what to do |
|---|
batch_held | 409 | The queued changes are on hold. Wait, or ask Corefinity support why. |
batch_window | 409 | The queued changes are being applied in the maintenance window. Wait for the window to finish. |
item_state | 409 | The queued change is no longer in a state that allows this. Read the pending changes again. |
nothing_pending | 409 | Nothing is queued to apply or cancel. Read the pending changes again. |
5
| Reason | Status | What it means and what to do |
|---|
location_gone | 409 | The audit's server location no longer exists. Choose another location for the audit. |
not_shared | 409 | The audit has no live share link. Share it first. |
nothing_to_run | 409 | The audit has no domains or pages to test. Add them to the audit first. |
run_in_progress | 409 | The audit is running. Wait for it to finish. |
too_large | 409 | What was sent is larger than the endpoint takes. The message names the limit; send less. |
5
| Reason | Status | What it means and what to do |
|---|
connect_failed | 503 | The site's cluster could not be reached. Try again in a minute. |
cut_over_unknown | 503 | Whether the site is past its go-live hold could not be confirmed, so nothing was changed. Try again in a minute. |
runtime_lacks_capability | 409 | The site's runtime does not support this yet. It is available after the site's platform update. |
site_cut_over | 409 | The site is past its go-live hold, so its platform plugins can no longer be turned off. Nothing to change. |
unavailable | 503 | This 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. |
2
| Reason | Status | What it means and what to do |
|---|
deployment_running | 409 | A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again. |
install_running | 409 | An installer is still running on the site. Contact support. |
Redirects
1
| Reason | Status | What it means and what to do |
|---|
cluster_paused | 409 | The 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
| Reason | Status | What it means and what to do |
|---|
exists | 409 | It already exists. Use the existing one. |
secret_invalid | 422 | The registry secret was refused. The message says why; correct it and send it again. |
Repository connections
2
| Reason | Status | What it means and what to do |
|---|
connection_in_use | 409 | Environments still deploy with this repository connection. Choose another connection in each one's deployment settings first. |
invalid_cursor | 422 | The cursor is not one the list gave. Start again from the first page. |
SSH keys
13
| Reason | Status | What it means and what to do |
|---|
not_found | 404 | The object does not exist, has expired, or is not yours to see. Check the id. |
ssh_cap_exceeded | 422 | There are too many keys here. Remove one you no longer need. |
ssh_environment_unmanaged | 422 | SSH on this environment is not managed by the Control Panel. Contact support. |
ssh_key_duplicate | 409 | The key is already added here. Use the existing one. |
ssh_key_invalid | 422 | That is not an SSH public key Corefinity can use. Paste one OpenSSH public key. |
ssh_key_weak | 422 | The key is too weak. Use an ed25519 key, or RSA of at least 3072 bits. |
ssh_legacy_ended | 422 | The Legacy key has already stopped working. Add the key again as a new key. |
ssh_managed_on_another_environment | 409 | This environment's SSH is managed on another environment. Make the change on the environment the answer names. |
ssh_not_legacy | 422 | That is not a Legacy key. Change it as an ordinary key. |
ssh_throttled | 429 | Too many SSH key changes or host key rotations were sent. Wait a minute and try again. |
ssh_host_keys_unmanaged | 422 | Host keys on this environment are managed by Corefinity. Nothing to rotate here. |
ssh_rotation_in_progress | 409 | A host-key rotation is already in progress. Wait for it to finish, or finish or cancel it. |
ssh_rotation_unavailable | 422 | The environment cannot rotate its host keys now, or there is no staged rotation to finish or cancel. Read the host keys again. |
Sites
10
| Reason | Status | What it means and what to do |
|---|
capacity_blocked | 409 | The cluster does not have room for this. Free some capacity, choose a smaller size, or move to a larger package. |
clone_in_progress | 409 | Another copy is running on the site. Wait for it to finish. |
cluster_deleting | 409 | The cluster is being deleted. Nothing can be changed on it. |
cluster_paused | 409 | The 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_progress | 409 | The site is still being deleted. Try again once it shows as deleted. |
has_environments | 409 | The site still has an environment that stops this. Read the message: delete its other environments first, or do what it names. |
not_restorable | 409 | A deleted environment cannot be restored: environments are removed at once. Recreate it from its final snapshot. |
not_acknowledged | 404 | The attention item has no acknowledgement to withdraw. Nothing needs doing. |
not_open | 404 | The attention item is no longer open. Read the list again. |
is_production | 409 | The production environment is the site itself. Delete the site instead. |
Snapshots
13
| Reason | Status | What it means and what to do |
|---|
disabled | 422 | Snapshots are not enabled for the site or its cluster. Contact support to have them turned on. |
google_cap | 429 | The hourly snapshot limit was reached. Try again later. |
in_flight | 409 | A snapshot is already being taken. Wait for it. |
manual_cap | 429 | The hourly limit of one-off snapshots for the environment was reached. Try again later. |
mariadb_change | 409 | The 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_healthy | 409 | The site is not running normally. Wait until it is, or contact support. |
platform_cluster | 409 | The 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. |
restoring | 409 | A restore is running. Wait for it to finish. |
setting_up | 409 | The site was created moments ago and its storage is not ready yet. Try again in a few minutes. |
settling | 409 | The database started moments ago and is still settling. Try again in a few minutes. |
state | 409, 422, 502, 503 | What the request acts on is not in a state that allows this. Read the message. |
unreadable | 502 | The site's state could not be read. Try again shortly. |
keep_cap_reached | 422 | Kept snapshots already use the most space allowed. Stop keeping another snapshot first. |
Support
3
| Reason | Status | What it means and what to do |
|---|
already_received | 409 | The upload already has its file. Create a new upload for another file. |
invalid_signature | 403 | The upload address has changed or expired. Create a new upload. |
state | 422 | What the request acts on is not in a state that allows this. Read the message. |
Team
9
| Reason | Status | What it means and what to do |
|---|
already_active | 403 | The person is already active. There is no invitation to send again. |
in_use | 409 | It 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_gone | 409 | The organisation the person was invited to no longer exists or is not active. Invite them again from an active organisation. |
last_owner | 403 | The organisation must keep at least one owner. Make someone else an owner first. |
not_connected | 409 | The outside account this needs is not connected for your company. Connect it first; the message names it. |
only_user | 403 | This is the only user in the organisation. Add another user first. |
owner_grant | 403 | Only an owner or Corefinity staff can make someone an owner. Ask an owner. |
permission_grant | 403 | You can give someone a role only if you hold all of its permissions yourself. Ask someone who holds them. |
privileged_target | 403 | That person's account can be changed only by Corefinity. Contact support. |
Terminal
1
| Reason | Status | What it means and what to do |
|---|
expired | 410 | What was asked for has expired or been deleted. Prepare it again where that is possible. |
Variables and secrets
6
| Reason | Status | What it means and what to do |
|---|
exists | 409 | It already exists. Use the existing one. |
secret_invalid | 422 | The registry secret was refused. The message says why; correct it and send it again. |
too_many_variables | 422 | The environment or company already has the most variables it can hold. Delete one first. |
variable_invalid | 422 | The variable's name or value is not allowed. The message says which rule; correct it. |
variable_reserved | 422 | The name is set by the platform. Choose another name. |
variable_tool_credential | 422 | Builds 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
| Reason | Status | What it means and what to do |
|---|
ack_required | 422 | The change has a warning that must be confirmed first. Send the acknowledgement the endpoint names, then send the change again. |
host_not_owned | 422 | A URL names a host that is not one of the site's. Purge only the site's own hosts. |
image_not_offered | 409 | The version the change needs is not available at the moment. Nothing was changed; try again later. |
invalid_tags | 422 | A cache tag is not one. Send tags as the site sets them. |
memory_split | 409 | Corefinity staff have divided the environment's memory between its services by hand, and this change would undo that. Ask support to make the change. |
unchanged | 409 | Nothing would change. Nothing to do. |
varnish_not_offered | 409, 422 | Varnish is available for Magento 2 sites only. Nothing to change here. |
varnish_off | 409, 422 | Varnish is off on the environment. Switch it on first. |
varnish_too_small | 422 | Varnish needs more memory than the package's cache share gives it. Choose a larger package, or switch RabbitMQ off. |
vcl_check_unavailable | 503 | The VCL could not be checked against the Varnish version. Try again in a minute. |
vcl_incompatible | 422 | Your VCL does not compile on that Varnish version. Change the VCL first, or keep the version. |
version_unsupported | 422 | That Varnish version is not offered, or not available yet. Choose another version. |
not_found | 404 | The object does not exist, has expired, or is not yours to see. Check the id. |
vcl_invalid | 422 | The VCL breaks a rule of the platform. Nothing was saved. Fix what the message names. |
vcl_locked | 422 | Corefinity manages this environment's VCL. Contact support to change it. |
Web server rules
9
| Reason | Status | What it means and what to do |
|---|
apply_not_supported | 422 | The change applies at once and cannot wait for a window. Send it without apply, or with apply: now. |
files_missing | 409 | The 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_behind | 409 | The files changed again after they were read. Read them again, then choose again. |
nginx_invalid | 422 | The Nginx rules have errors and were not saved. Fix the errors the answer lists. |
nginx_rules_locked | 422 | Corefinity has locked this environment's Nginx rules. Contact Corefinity support to change them. |
no_drift | 422 | The files are the ones the Control Panel last committed: there is no change made outside it to answer. Nothing to do. |
not_admitted | 422 | The change cannot wait for tonight's window. Send it with apply: now. |
not_found | 404 | The object does not exist, has expired, or is not yours to see. Check the id. |
too_large | 413 | What was sent is larger than the endpoint takes. The message names the limit; send less. |
Websites and environments
3
| Reason | Status | What it means and what to do |
|---|
billing_forbidden | 403 | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
confirm_cost | 422 | The change costs more each month. Send confirm_cost: true once the cost in the message is agreed. |
warning_not_acknowledged | 422 | The chosen size carries a warning. Send the acknowledgement the message names to keep it, or choose a larger size. |
Handling refusals in code
| Rule | Reason |
|---|
Branch on reason | Messages can be reworded |
Retry 429 and 502 after a wait | They 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 started | switched_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 blind | Wait for the state to change, or read again first |
Never retry 401, 403, 404 or 422 unchanged | The same request gets the same answer |
Each endpoint's reference page lists the reasons it can give.