---
title: "corestack_runtime_adopt"
url: https://docs.corefinity.com/mcp/tools/corestack_runtime_adopt
type: tool
last_updated: 2026-11-13
feature: php-runtime
related:
  - https://docs.corefinity.com/api/reference/runtime/adopt-runtime.md
  - https://docs.corefinity.com/guides/sites/software-and-services/php-version.md
---
# corestack_runtime_adopt

**Turn on instant changes.** Move a row onto the new runtime, so later PHP, nginx and Node.js changes apply straight away: now or tonight in its maintenance window. corestack_runtime_get's adoption says whether it is offered and why not. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Runs as a task: yes

## When to use it

Move a row onto the new runtime, so later PHP, nginx and Node.js changes apply straight away: now or tonight in its maintenance window. corestack_runtime_get's adoption says whether it is offered and why not.

## Inputs

- `site_id` (integer, ≥ 1, required): The row: the site or one of its environments.
- `apply` (one of `now`, `tonight`, default `"now"`): now (the default), or tonight in the row's maintenance window.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "default": "now",
      "description": "now (the default), or tonight in the row's maintenance window. window: the row's next maintenance window (tonight is kept as its alias).",
      "enum": [
        "now",
        "window",
        "tonight"
      ],
      "type": "string"
    },
    "site_id": {
      "description": "The row: the site or one of its environments.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `already_adopted`: the row is already on the new runtime; there is nothing to do.
- `busy`: the row is adopting already; follow it with corestack_runtime_get.
- `runtime_not_adopted`: adoption is not open for this row yet (`details.adoption` says why); try again later.
- `feature_off`: `apply: "tonight"` needs the maintenance window queue, which is switched off; leave `apply` out to make the change now.
- `batch_window`: this row can only adopt inside its maintenance window, or other maintenance is already queued for it; call again with `apply: "tonight"`.
- `change_pending`: another change is queued for this row's window; apply or cancel it first (corestack_pending_changes_list).
- `migration_halted`: tonight's maintenance is halted, so nothing was changed; try again once Corefinity resumes it.
- `canary_pending`: the new runtime is still at its canary stage and open to canary rows only; try again once it opens to every row.
- `apm_provenance_unreadable`: the row's New Relic set-up could not be read, so nothing was changed. Contact support.
- `image_volume_unsupported`: part of the row's cluster cannot run the new runtime yet; Corefinity upgrades it; try again after.
- `legacy_module_unmapped`: the row loads a PHP module the new runtime does not offer yet; Corefinity reviews it and nothing was changed.
- `not_available`: this row cannot move onto the new runtime (`details.adoption` says why).
- `removed`: the row has been removed.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- `temporarily_unavailable` (the Control Panel answers 409 `image_not_offered`): the runtime image round this adoption needs is not one Corefinity offers right now (withdrawn, or not published yet). Nothing was changed; send it again once Corefinity offers that round.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_runtime_adopt",
  "arguments": {
    "site_id": 4211,
    "apply": "tonight"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_runtime_adopt with site_id 4211, apply tonight. (Turn on instant changes.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/runtime/adopt](https://docs.corefinity.com/api/reference/runtime/adopt-runtime.md)
- Guide: [Change PHP version](https://docs.corefinity.com/guides/sites/software-and-services/php-version.md)
