---
title: "Refusals"
url: https://docs.corefinity.com/mcp/refusals
type: page
last_updated: 2026-11-13
feature: mcp
---
# Refusals

Every reason the MCP server refuses a call, what it means and what the assistant or the person should do next.

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.

```json
{
  "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](/mcp/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](/mcp/limit-a-grant). |
| `confirm_mismatch`            | A typed confirmation does not match.                                                | Ask the person for the exact value. See [Confirmations](/mcp/confirmations).                      |
| `rate_limited`                | Too many calls.                                                                     | Wait `retry_after_seconds`. See [Limits](/mcp/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](/api/errors). The answer's `message` is about the request; the meaning here holds whatever the request.

### Objects and lifecycle

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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

| 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`.                            |
