Refusals
Every reason the MCP server refuses a call, what it means and what the assistant or the person should do next.
On this page
A refused tool call is a normal tool result with isError: true, a stable reason and a message in plain words. The assistant reads the reason and acts on it.
{
"error": {
"reason": "pin_refused",
"message": "This token is limited to other sites. Ask the token's creator or a company owner to add this one.",
"object": { "kind": "site", "id": 1042 },
"link": "https://manage.corefinity.com/…"
}
}| Field | Present | Holds |
|---|---|---|
reason | Always | The machine reason, from the tables below |
message | Always | A sentence for the person, about this request |
fields | invalid_arguments | Each wrong argument and why |
field | confirm_mismatch | The confirmation that was wrong |
scopes_needed, scopes_missing, link | scope_required | What the call needs and where to add it |
object or action, link | pin_refused | What lies outside the pins and where to add it |
link | Some not_available answers | The Control Panel page where the person does it |
retry_after_seconds | When the wait is known | When to try again |
detail_reason | Some refusals | A more specific reason, where reason keeps the word it has always answered; see below |
details | Some reasons | More from the Control Panel, such as what blocks the change |
trace_id | internal_error | The id to quote to support |
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, beside reason in the error. Read detail_reason when it is present, else reason.
| When | reason | detail_reason |
|---|---|---|
| A deployment or a rehearsal on a site with no repository connected | invalid_arguments | no_repository |
| A waiting deployment that can no longer be started | conflict | stale |
| A PageSpeed test, or a command on a site, while that is switched off | temporarily_unavailable | switched_off |
| A PHP or MariaDB version change while an earlier upgrade has not finished | invalid_arguments | not_available |
| A version that cannot be changed at the moment, met through another tool | invalid_arguments | temporarily_unavailable, not_available, busy or removed |
Any tool
| Reason | Meaning | What to do |
|---|---|---|
invalid_arguments | An argument is missing or wrong. | Fix what fields names and call again. |
tenant_mismatch | The object does not exist, or is not yours to see. Both answer the same. | Check the id. |
scope_required | A personal token lacks a scope the call needs. | Ask the person to open link and save, then call again. See Scopes. |
pin_refused | The object or action is outside the grant's pins. | Ask the person to open link and save, then call again. See Limit a grant. |
confirm_mismatch | A typed confirmation does not match. | Ask the person for the exact value. See Confirmations. |
rate_limited | Too many calls. | Wait retry_after_seconds. See Limits. |
switched_off | Corefinity has switched this kind of action off for now. Nothing was started. | Try again later. |
forbidden | The person is not allowed to do this. | Stop. |
conflict | The action conflicts with the object's present state. | Read message. |
not_available | The tool does not apply to this object, or the action is done in the Control Panel. | Give the person link where there is one. |
wrong_row | The tool needs a production site and was given an environment, or the reverse. | Use the other id or the other tool. |
expired | The link, recording or transfer has expired. | Start again. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started. | Try again shortly. |
upstream_unavailable | A service the action depends on did not answer. | Try again later. |
internal_error | Something went wrong on Corefinity's side. | Quote trace_id to support. |
interaction_rounds_exceeded | The call asked the person for input 3 times without finishing. | Start again. |
Work and tasks
| Reason | Meaning | What to do |
|---|---|---|
work_failed | The task ran and ended in failure. | Read details. Offer corestack_operation_retry where it applies. |
not_retryable | The operation cannot be retried. | Make the change again. |
not_open | The attention item is no longer open. | Read the list again. |
not_acknowledged | The attention item has no acknowledgement to withdraw. | Read the list again. |
cluster_not_empty | The cluster still holds sites, environments or backups. | Show the person what would be removed. Call again with allow_non_empty: true only if they agree. |
already_revealed | A one-time secret was already shown. | Offer a reset where the tool has one. |
nothing_saved | There is nothing saved to put back. | Nothing to do. |
Commands
| Reason | Meaning | What to do |
|---|---|---|
command_failed | The command ran and exited with an error. | Read its output with corestack_command_output_get. |
timed_out | The command ran out of time. | Read its output. Run it again with a longer timeout_seconds if needed. |
ended_without_status | The command ended without reporting a result. | Read its output. |
container_replaced | The site's container was replaced while the command ran. | Run it again. |
cancelled | The command or transfer was stopped. | Nothing to do. |
grant_revoked | The work was stopped because access was revoked. | The person creates a new token or approves the app again. |
grant_expired | The work was stopped because access expired. | The person creates a new token or approves the app again. |
not_cancellable | The command cannot be cancelled from here. | Stop. |
already_finished | The command has already ended. | Read its output. |
too_many_commands | Too many commands are running. | Wait for one to finish, or cancel one. |
Files and transfers
| Reason | Meaning | What to do |
|---|---|---|
path_outside_site | The path leads outside the site. | Use a path under the site root. |
path_public | The path is inside the public web folder, where the file would be served. | Choose a path outside it. |
content_changed | The file changed since it was read. | Read it again and decide. |
import_running | Another import into the same database is running. | Wait for it. |
checksum_mismatch | The uploaded bytes do not match the checksum given. | Upload again. |
format_unsupported | The archive format is not supported. | Repack it as tar, tar.gz, tar.zst or zip. |
insufficient_space | The site does not have enough free disk space. Nothing was written. | Free space, or choose a larger size. |
too_large | The upload is larger than the limit for one file. | Split it. |
quota_exceeded | The upload would take the organisation or the site over its transfer allowance. | Wait for older transfers to expire. |
transfer_not_ready | The upload has not finished. | Finish it, then call again. |
git_mode | The site deploys from Git, so files cannot be synced into it. | Switch it to manual deployment first. |
transfers_unavailable | File transfers are not available in the site's region. | Move the files over SSH instead. |
Reasons from the Control Panel
A tool passes on the Control Panel's own reasons unchanged, so the API answers the same ones: see Errors and refusals. The answer's message is about the request; the meaning here holds whatever the request.
28 groups
Objects and lifecycle
33
| Reason | Meaning | What to do |
|---|---|---|
busy | Another change or command is running on what the request acts on. | Wait for it to finish, then try again. |
stale | What you read has changed since you read it. | Read it again, then send the change with its new version or quote. |
deleted | The site, environment or copy has been deleted, or is being deleted. | Nothing can be changed on it. Restore a deleted site first if it can still be restored. |
removed | The site or environment is being removed, or has been. | Nothing can be changed on it. |
is_production | The production environment is the site itself. | Delete the site instead. |
not_restorable | A deleted environment cannot be restored: environments are removed at once. | Recreate it from its final backup. |
not_running | The site, environment or deployment is not running. | Read the message: where it can be started or will recover, start it or wait, then try again. |
restore_running | A restore is running on the site. | Wait for it to finish, then try again. |
snapshot_running | A backup of the site is still being taken. | Wait for it to finish, then try again. |
command_running | Another action or command is still running on the site. | Wait for it to finish, then try again. |
deployment_running | 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 | An installer is still running on the site. | Contact support. |
provisioning | The site is still being created. | Try again in a few minutes. |
managed_elsewhere | The site is managed by another control panel. | Make the change there. |
exec_unresolved | An earlier command on the site has not been confirmed stopped. | Contact support. |
duplicate | The same thing already exists here. | Use the existing one, or choose another name or value. |
exists | It already exists. | Use the existing one. |
in_use | 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. |
staff_managed | Corefinity staff manage this for the site. | Contact support to change it. |
staff_removal | The cluster holds something only Corefinity can remove. | Contact support to delete it. |
unavailable | 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. |
cleaning_up | The site, the environment or its last restore is still being cleaned up or removed. | Try again in a few minutes. |
deletion_in_progress | The site is still being deleted. | Try again once it shows as deleted. |
has_environments | The site still has an environment that stops this. | Read the message: delete its other environments first, or do what it names. |
already_attached | The environment already has a domain. | Change it under Domains instead. |
already_live | The site is already live on a domain. | Change its domains instead. |
no_port | The environment has no SSH port yet. | Contact support. |
item_state | The queued change is no longer in a state that allows this. | Read the pending changes again. |
feature_off | The feature, or the input that needs it, is not switched on. | Leave that input out, or ask Corefinity about the feature. |
confirm | The action needs an explicit confirmation field. | Ask the person, then send it. |
throttled | Too many tries. | Wait a minute and try again. |
unchanged | Nothing would change. | Nothing to do. |
runtime_lacks_capability | The site's runtime does not support this. | Wait for the site's platform update. |
Copies and new environments
3
| Reason | Meaning | What to do |
|---|---|---|
source_busy | The environment to copy from is busy with another change, or is being deleted. | Nothing was copied. Wait, then try again. |
target_busy | The environment to copy or restore into is busy with another change. | Nothing was changed. Wait, then try again. |
clone_in_progress | Another copy is running on the site. | Wait for it to finish. |
Clusters and capacity
22
| Reason | Meaning | What to do |
|---|---|---|
capacity_blocked | The cluster does not have room for this. | Free some capacity, choose a smaller size, or move to a larger package. |
compute_capacity_blocked | The platform does not have the server capacity for this at the moment. | Try again later, or contact support. |
cluster_busy | Another change to the cluster is running. | Wait for it to finish, then try again. |
cluster_deleting | The cluster is being deleted. | Nothing can be changed on it. |
cluster_not_ready | The cluster is still being created. | Try again once it is ready. |
cluster_migrating | The cluster is moving to its new package. | Try again once it has finished. |
cluster_legacy | Capacity for this cluster is arranged with support. | Contact support. |
legacy_cluster | Corefinity manages this cluster. | Contact support to change its package or delete it. |
cluster_site | The site's package is its CoreCluster's. | Change the cluster's package instead. |
platform_cluster | 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. |
no_platform_cluster | The region has no CoreStack platform. | Choose another region. |
pool_retiring | The cluster's servers are being replaced. | Try again once that has finished. |
pool_generation_exhausted | The cluster has changed machine type as often as it can. | Contact support. |
region_unavailable | The region has no room for this at the moment. | Choose another region, or try again later. |
different_cluster | A copy works within one cluster, and the target is in another. | Choose a target in the same cluster. |
too_small | The target is too small for what it would hold. | Choose a larger size. |
compute_blocked | There is no server capacity for this size at the moment. | Choose another size, or contact support. |
disk_not_growable | The site's disk cannot be made larger from here. | Contact support. |
support_only | A previous restore or upgrade left unfinished work, or Corefinity holds the site's storage. | Contact support; trying again cannot help. |
capacity_changes_paused | Changes to cluster capacity are paused for maintenance. | Try again later, or contact support if it is urgent. |
memory_split | 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. |
family_change_pending | The cluster is already changing to another server type. | Wait for that change to finish. |
Packages and add-ons
12
| Reason | Meaning | What to do |
|---|---|---|
billing_forbidden | Billing is for the organisation's owner and billing contacts. | Ask one of them to do this. |
contract_missing | 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. |
no_payment_method | There is no payment method on the account. | Add a card or a Direct Debit mandate first. |
same_package | This is already the package. | Choose a different one. |
downgrade | A smaller package cannot be chosen here. | Choose a larger one; downgrades are arranged with support. |
package_platform | The package is not offered for the site's platform. | Choose a package that is. |
same_family | This is already the server type. | Choose a different one. |
family_unavailable | That server type is not available here. | Choose another server type or region. |
same_addons | These are already the add-ons. | Change a quantity first. |
addon_bounds | An add-on quantity is outside what is allowed. | Choose a whole number inside the range the message gives. |
included_size | The included staging environment cannot be smaller than its included size. | Choose that size or a larger one. |
auto_upgrades_unavailable | Automatic upgrades are not available for the organisation. | Read the message, or contact support. |
Pending changes
8
| Reason | Meaning | What to do |
|---|---|---|
change_pending | A change is already queued for tonight. | Apply it now or cancel it first. |
restart_batches_off | Changes cannot be queued for the maintenance window at the moment. | Apply the change now instead. |
batch_running | The queued changes are being applied now. | Wait for them to finish. |
nothing_pending | Nothing is queued to apply or cancel. | Read the pending changes again. |
no_node | There is no room to apply the changes now. | Try again later, or leave them for tonight. |
node_full | There is no room to apply the changes now. | Try again later, or leave them for tonight. |
node_busy | There is no room to apply the changes now. | Try again later, or leave them for tonight. |
batch_window | The changes apply in tonight's maintenance window. | Leave them queued for the window. |
Domains and URLs
4
| Reason | Meaning | What to do |
|---|---|---|
preview_only | The environment has no domain attached yet. | Attach one first. |
domains_locked | 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. |
no_zone | 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 | The outside account this needs is not connected for your company. | Connect it first; the message names it. |
Password protection
2
| Reason | Meaning | What to do |
|---|---|---|
legacy_adopt_pending | Password protection is being prepared for the site and is not available yet. | Try again later. |
legacy_domain_attached | Password protection is not available on the site until Corefinity has made a platform change. | Contact support. |
Firewall
13
| Reason | Meaning | What to do |
|---|---|---|
firewall_address_invalid | The address is not an IPv4 or IPv6 address, or a range in CIDR form. | Send one, such as 203.0.113.0/24. |
firewall_width_refused | The range is too wide: /8 or wider is never accepted. | Send a narrower range. |
firewall_address_refused | The address is in a private, reserved or provider range. | Send another address. |
firewall_approval_required | A range wider than /24 (IPv6 /48) needs approval from Corefinity. | Send it as a range request. |
firewall_cap_exceeded | The change would take the firewall over its limit. | Remove an entry first. |
firewall_scope_invalid | That scope cannot apply to the address here. | Choose another scope. |
firewall_scope_unavailable | Site access is not available for the environment. | Nothing to change here. |
firewall_not_covered | The firewall does not manage SSH for the environment. | Nothing to change here. |
firewall_duplicate | The address is already on the list. | Nothing to do. |
firewall_state_conflict | The entry has changed since it was read. | Read the list again, then try again. |
firewall_preset_present | The preset is already attached. | Nothing to do. |
firewall_two_factor_required | Changing the firewall needs two-factor authentication. | Set it up first. |
firewall_not_editable | The person can see the entry but cannot change it. | Stop. |
Backups and restores
11
| Reason | Meaning | What to do |
|---|---|---|
disabled | Backups are not enabled for the site or its cluster. | Contact support to have them turned on. |
restoring | A restore is running. | Wait for it to finish. |
mariadb_change | The database version is changing, or the backup's database version does not fit the environment. | Read the message: wait for the change to finish, or restore into a new environment. |
in_flight | A backup is already being taken. | Wait for it. |
manual_cap | The hourly limit of one-off backups for the environment was reached. | Try again later. |
google_cap | The hourly backup limit was reached. | Try again later. |
not_healthy | The site is not running normally. | Wait until it is, or contact support. |
settling | The database started moments ago and is still settling. | Try again in a few minutes. |
unreadable | The site's state could not be read. | Try again shortly. |
state | What the request acts on is not in a state that allows this. | Read the message. |
setting_up | The site was created moments ago and its storage is not ready yet. | Try again in a few minutes. |
Deployments and commands
15
| Reason | Meaning | What to do |
|---|---|---|
mode | 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 | The repository's connection is gone or needs authorising again. | Reconnect the repository. |
not_failed | Only a failed deployment can be retried. | Deploy again instead. |
rollback_not_retryable | A rollback cannot be retried. | Roll back again, or deploy. |
wrong_platform | This is not available for the site's platform. | Use it on a site of the platform it is for. |
artifact_pruned | The deployment's archive was removed after 30 days, so it cannot be retried or rolled back. | Deploy again from the branch or commit. |
retry_from_step_unavailable | This deployment cannot be retried from the step that failed. | Retry it from the start, or deploy again. |
site_content_off | Deploying site content is paused by Corefinity. | Nothing was changed. Try again later. |
pipeline_changed_since_build | The pipeline changed after this deployment was built. | Deploy again instead of retrying. |
variable_tool_credential | 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. |
line_own_shell | A pipeline line changes directory on its own, which does nothing for the next line: each line runs in its own shell. | Join the commands on one line with &&. |
no_namespace | The environment is not set up on its cluster yet. | Contact support. |
no_repository | The site has no repository connected. | Connect one first. |
bedrock_layout | The WordPress site is built with Bedrock, so it cannot switch to manual deployments. | Keep deploying it with Git. |
scripts_memory | Install scripts need more command-line memory than the environment has. | Choose a larger size, or leave install scripts off. |
Sign-in settings
2
| Reason | Meaning | What to do |
|---|---|---|
confirmation_required | Staying signed in longer needs you to confirm it is you. | Confirm it in the Control Panel, then try again. |
trust_above_session_limit | 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. |
Cloudflare SSL rules
4
| Reason | Meaning | What to do |
|---|---|---|
rules_not_allowed | The Cloudflare token may not change the zone's rules. | Allow Zone, Config Rules, Edit on the token, or connect one that can. |
rule_edited | 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. |
not_owner | The Cloudflare rule belongs to another change, so it was left as it is. | Wait for that change to finish. |
zone_ssl | DNS was not pointed at Corefinity, because of the Cloudflare zone's SSL/TLS mode. | Ask the person to confirm the mode the answer names, then send set_ssl_mode. |
Demos
9
| Reason | Meaning | What to do |
|---|---|---|
demo_building | The demo is still being set up. | Keep it once it is ready. |
demo_closed | The demo has ended and can no longer be kept. | Start an order to carry on. |
already_kept | The demo has already been kept. | Nothing to do. |
forbidden_role | Keeping a demo needs the organisation's owner or a billing role. | Ask the owner to keep it. |
billing_details_required | Billing details are needed to keep the demo. | Add them, then keep it. |
payment_method_required | A payment method is needed to keep the demo. | Add one, then keep it. |
privacy_required | The privacy notice has not been accepted. | Accept it to keep the demo. |
package_not_offered | The package chosen for the demo is not offered. | Choose one that is. |
demo_keep_required | Creating CoreStack sites needs the demo to be kept first. | Keep your demo, then try again. |
Terminal
2
| Reason | Meaning | What to do |
|---|---|---|
relay_unavailable | The terminal service is unavailable. | Try again in a minute. |
limit | 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. |
Logs
6
| Reason | Meaning | What to do |
|---|---|---|
logs_unavailable | Logs could not be read, or are not collected for the site yet. | Read the message; try again shortly. |
logs_not_collected | Logs are not being collected for the environment yet. | Try again later, or contact support. |
logs_range | The time range is outside the days logs are kept for. | Choose a range inside the days the message names. |
query_too_wide | The search covers too much. | Choose a shorter range or a narrower search. |
logs_cluster_unavailable | Logs are not available at the moment. | Try again shortly. |
line_not_found | The log line is no longer available. | Search again. |
Billing
10
| Reason | Meaning | What to do |
|---|---|---|
pdf_pending | The invoice's PDF is not ready yet. | Try again in a few minutes. |
credit_note_not_ready | The credit note is not ready yet. | Try again shortly. |
provider_unavailable | The payment provider, or the old host, did not answer. | Try again later. |
not_resizable | The site's disk size cannot be changed from here. | Contact support. |
package_unknown | That is not a package Corefinity sells for this. | Choose one from the catalogue. |
package_inactive | The package is no longer offered. | Choose another package. |
currency_unpublished | Prices in that currency are not available right now. | Choose another currency, or try again later. |
zone_unknown | That is not a region. | Choose uk, us, nl or aus. |
uat_unknown | That is not a staging environment size. | Choose one from the catalogue. |
orders_forbidden | Orders are for the organisation's owner and people with a billing role. | Ask one of them. |
SSH keys and logins
20
| Reason | Meaning | What to do |
|---|---|---|
ssh_key_invalid | That is not an SSH public key Corefinity can use. | Paste one OpenSSH public key. |
ssh_key_weak | The key is too weak. | Use an ed25519 key, or RSA of at least 3072 bits. |
ssh_private_key_refused | A private key was pasted. It was not stored. | Paste the public key (.pub) instead. |
ssh_key_duplicate | The key is already added here. | Use the existing one. |
ssh_cap_exceeded | There are too many keys here. | Remove one you no longer need. |
ssh_staff_key_refused | The key is on Corefinity's list of staff and system keys, so it cannot be added. | If it is your own key, contact support. |
ssh_environment_unmanaged | SSH on this environment is not managed by the Control Panel. | Contact support. |
ssh_host_keys_unmanaged | Host keys on this environment are managed by Corefinity. | Nothing to rotate here. |
ssh_rotation_unavailable | The environment cannot rotate its host keys now, or there is no staged rotation to finish or cancel. | Read the host keys again. |
ssh_rotation_in_progress | A host-key rotation is already in progress. | Wait for it to finish, or finish or cancel it. |
ssh_not_legacy | That is not a Legacy key. | Change it as an ordinary key. |
ssh_legacy_ended | The Legacy key has already stopped working. | Add the key again as a new key. |
ssh_person_managed_elsewhere | That username belongs to a person's own SSH login, managed in their profile. | Choose another name. |
enterprise_panel_only | SSH keys for CoreStack Enterprise environments are managed in the Control Panel only at the moment. | Make the change there. |
ssh_options_refused | The pasted line carries options before the key type. | Remove them: keys are added without options. |
ssh_key_type_unsupported | Security keys (sk-) are not supported. | Use an ed25519 key. |
ssh_handle_missing | The organisation has no SSH handle yet, so people have no login of their own. | Use the shared login, or ask Corefinity to set the handle. |
ssh_login_unavailable | Your own login cannot be used on this environment now. | Use the shared login. |
ssh_uid_range_exhausted | A username cannot be issued right now. | Contact support. |
ssh_managed_on_another_environment | This environment's SSH is managed on another environment. | Make the change on the environment the answer names. |
Maintenance windows
4
| Reason | Meaning | What to do |
|---|---|---|
window_start_invalid | The start hour is not one. | Choose an hour from 00 to 23. |
window_scope_unavailable | This has no maintenance window of its own. | Set the window on its site or cluster. |
window_locked | The maintenance window is set by Corefinity. | Contact support to change it. |
batch_applying | Maintenance is running on the site now. | Try again when it finishes. |
Application versions
13
| Reason | Meaning | What to do |
|---|---|---|
catalogue_unavailable | Application versions cannot be read at the moment. | Try again in a few minutes. |
app_version_unknown | The version is not one Corefinity offers. | Choose a version that is. |
app_version_unavailable | The version is not available. | Choose another version. |
app_version_eol | The version no longer receives security fixes. | Choose a newer version, or an empty site to move an existing application into. |
app_version_held | New installs of the version are paused. | Choose another version. |
app_version_untested | The version has not finished testing. | Choose another version. |
app_version_arch | The version is not available on the cluster. | Choose another version. |
edition_unavailable | The edition is not available. | Choose another edition. |
commerce_keys_required | Adobe Commerce needs the organisation's own Magento Marketplace keys. | Add them first. |
commerce_not_entitled | The organisation's Magento Marketplace keys do not include Adobe Commerce. | Add keys that do. |
commerce_check_unavailable | The Magento Marketplace keys could not be checked. | Try again in a few minutes. |
php_not_in_line | The PHP version is not offered for the application version. | Choose a PHP version that is. |
mariadb_not_in_line | The MariaDB version is not offered for the application version. | Choose a MariaDB version that is. |
Copies and restores elsewhere
17
| Reason | Meaning | What to do |
|---|---|---|
snapshot_transfer | A saved backup can be copied only to an environment on the same servers for now. | Copy the live environment instead, or restore the backup first. |
not_permitted | The person cannot copy or restore into the target. | Stop. |
copy_limit | The organisation already has 3 copies or restores running. | Try again when one has finished. |
copy_target_staging_only | The site's copies are for staging only and cannot replace production. | Copy into a staging environment. |
target_too_small | The backup is larger than the space the environment has. | Choose a larger size. |
cross_region | The backup is in another region. | Contact support to restore it here. |
snapshot_unavailable | The backup cannot be restored, or the safety backup could not be taken. Nothing was copied. | Choose another backup, or try again shortly. |
copy_runtime_unavailable | The copy cannot run at the moment. Nothing was changed. | Try again later. |
final_expired | The final backup has passed its restorable-until date. | It can no longer be restored. |
not_offered | The backup cannot be restored this way. | Read the message. |
keep_cap_reached | Kept backups already use the most space allowed. | Stop keeping another backup first. |
runtime_unprepared | The environment needs a platform update before it can take the copy or restore. Nothing was changed. | Contact support. |
legacy_search | The site's search runs on a temporary older engine. | Switch the store to the OpenSearch module first. |
neutralise_off | Copies are paused at the moment. | Try again later. |
consumer_hold_off | Copies are paused at the moment. | Try again later. |
source_unsupported | The environment cannot be copied as it is. | Contact support. |
ssh_unreachable | The environment could not be read. | Try again in a few minutes, or contact support. |
Varnish
14
| Reason | Meaning | What to do |
|---|---|---|
varnish_not_offered | Varnish is available for Magento 2 sites only. | Nothing to change here. |
varnish_off | Varnish is off on the environment. | Switch it on first. |
varnish_too_small | Varnish needs more memory than the package's cache share gives it. | Choose a larger package, or switch RabbitMQ off. |
version_unsupported | That Varnish version is not offered, or not available. | Choose another version. |
invalid_tags | A cache tag is not one. | Send tags as the site sets them. |
invalid_urls | A URL to purge is not one. | Send full URLs of the site. |
host_not_owned | A URL names a host that is not one of the site's. | Purge only the site's own hosts. |
invalid_pattern | The purge pattern is not accepted. | Send a simpler pattern. |
change_in_progress | Another change to Varnish is in progress. | Wait for it to finish. |
magento_config_failed | Magento's cache settings could not be changed, so nothing was changed. | Try again; contact support if it stays. |
vcl_incompatible | Your VCL does not compile on that Varnish version. | Change the VCL first, or keep the version. |
vcl_invalid | The VCL breaks a rule of the platform. Nothing was saved. | Fix what the message names. |
vcl_compile_failed | The VCL does not compile. Nothing was saved. | Fix the error the message names. |
vcl_locked | Corefinity manages this environment's VCL. | Contact support to change it. |
Databases and external access
12
| Reason | Meaning | What to do |
|---|---|---|
user_not_found | There is no such database user on the environment. | Read the users again. |
user_cap | The environment holds as many database users as it can. | Delete one you no longer need, or ask support. |
reveal_gone | The password can no longer be shown. | Rotate it to get a new one. |
external_off | External access is off, and external users connect through it. | Turn external access on first. |
external_db_not_available | External access is not available on the environment. | Ask support. |
external_db_already_on | External access is already on. | Nothing to do. |
external_db_already_off | External access is already off. | Nothing to do. |
external_db_not_on | External access is off. | Turn it on first. |
external_db_unchanged | The allowed addresses are already exactly these. | Nothing to do. |
external_db_failed | External access could not be turned on. | Contact support so it can be finished or undone. |
external_db_turning_off | External access is being turned off before the delete. | Wait for it, then delete again. |
external_db_delete_queued | External access is being turned off first; the delete follows by itself. | Nothing to do. |
Error pages
5
| Reason | Meaning | What to do |
|---|---|---|
error_pages_locked | Corefinity has locked the environment's error pages. | Contact support to change them. |
operation_in_progress | A change to the environment is in progress. | Try again when it has finished. |
switch_reconcile_failed | The maintenance switch could not be checked on the site, so nothing was changed. | Try again shortly. |
invalid_page | An error page cannot be saved as it is. | Fix the errors the answer lists. |
overlap_nginx_rules | The site's nginx rules already handle that error with an error_page of their own. | Keep that as the app's page, or remove the line from the nginx rules first. |
Web server rules
4
| Reason | Meaning | What to do |
|---|---|---|
no_drift | The files are the ones the Control Panel last committed: there is no change made outside it to answer. | Nothing to do. |
inventory_behind | The files changed again after they were read. | Read them again, then choose again. |
files_missing | 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. |
path_apps_unavailable | Path apps are not offered on this environment. | Nothing to change here. |
People and roles
8
| Reason | Meaning | What to do |
|---|---|---|
privileged_target | That person's account can be changed only by Corefinity. | Contact support. |
last_owner | The organisation must keep at least one owner. | Make someone else an owner first. |
only_user | This is the only user in the organisation. | Add another user first. |
already_active | The person is already active. | There is no invitation to send again. |
invite_company_gone | The organisation the person was invited to no longer exists or is not active. | Invite them again from an active organisation. |
own_permissions_upward | An assistant cannot give the person it acts for a role or permission they do not already hold. | Ask the person to make the change in the Control Panel. |
owner_grant | Only an owner or Corefinity staff can make someone an owner. | Ask an owner. |
permission_grant | You can give someone a role only if you hold all of its permissions yourself. | Ask someone who holds them. |
Platform plugins
4
| Reason | Meaning | What to do |
|---|---|---|
platform_plugins_off | The site's platform plugins are turned off, and this needs them. | Turn them back on first. |
platform_plugins_applying | The platform plugins are still being turned back on. | Try again in a minute. |
site_cut_over | The site is past its go-live hold, so its platform plugins can no longer be turned off. | Nothing to change. |
cut_over_unknown | Whether the site is past its go-live hold could not be confirmed, so nothing was changed. | Try again in a minute. |
Performance audits
4
| Reason | Meaning | What to do |
|---|---|---|
run_in_progress | The audit is running. | Wait for it to finish. |
nothing_to_run | The audit has no domains or pages to test. | Add them to the audit first. |
location_gone | The audit's server location no longer exists. | Choose another location for the audit. |
not_shared | The audit has no live share link. | Share it first. |
Copies of a CoreStack Enterprise environment
15
| Reason | Meaning | What to do |
|---|---|---|
copy_exists | The target already has an unfinished copy. | Finish or re-sync that one. |
copy_running | The copy is still running. | Wait for its run to end. |
copy_ended | The copy has ended already. | Start a new copy. |
copy_not_latest | A newer copy of the site exists. | Re-sync that one. |
copy_unchecked | The copy's checks did not complete, so it cannot be finished. | Re-sync it. |
source_moving | The environment has a move open, or has moved to CoreStack. | Copy it once the move is settled, or copy from its new site. |
no_mail_neutraliser | Copies of sites of this platform are not available: their email cannot be switched off on the copy. | Contact support. |
other_company | The site belongs to another organisation than the environment. | Copy into a site of the environment's own organisation. |
target_not_ready | 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_live | 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_sends_mail | The site to copy into sends email through its own sending domain, and a copy must never send email. | Choose another site. |
platform_mismatch | The site and the environment run different platforms. | Copy into a site of the same platform. |
target_unprotected | The site to copy into is not protected by password protection over the whole environment. | Protect it first: copied data must never be public. |
target_crons_on | The site to copy into has its scheduled tasks on. | Switch them off before copying into it. |
target_moving | The site to copy into is part of an environment move. | Copy into it once the move is settled. |
Before a tool runs
These are HTTP answers, not tool results. The client handles them.
| Status | Body | Meaning | What to do |
|---|---|---|---|
| 401 | missing_token, invalid_token | No token, or one that is unknown, expired or revoked. | Sign in again, or create a new token. |
| 403 | insufficient_scope | An OAuth connection lacks a scope. | Approve the scopes on the page the app opens. |
| 403 | ip_not_allowed | The request came from outside the grant's allow-list. | Connect from an allowed address, or edit the list. |
| 429 | rate_limited, too_many_in_flight | A request limit was reached. | Wait for Retry-After. |
Was this helpful?