---
title: "corestack_deployments_pipeline_settings_update"
url: https://docs.corefinity.com/mcp/tools/corestack_deployments_pipeline_settings_update
type: tool
last_updated: 2026-11-13
feature: deployment-pipeline
related:
  - https://docs.corefinity.com/api/reference/deployments/update-site-deployment-pipeline-settings.md
  - https://docs.corefinity.com/guides/sites/code-and-deployments/pipeline-stages.md
---
# corestack_deployments_pipeline_settings_update

**Update pipeline settings.** Change a deployment pipeline's settings: maintenance page, build tunnels, pausing scheduled tasks, Laravel migrations, timeouts and kept node_modules. Only the settings you send change. Scope: write.

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

## When to use it

Change a deployment pipeline's settings: the maintenance page, build tunnels, pausing scheduled tasks, Laravel migrations, timeouts and kept node_modules. Only the settings you send change; it runs nothing.

The same action in the public REST API, with the same checks, refusals and scope: `PUT /api/corestack/sites/{site}/deployments/pipeline/{binding}/settings`.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `binding_id` (integer, ≥ 1): Default: the environment's default binding.
- `revision` (string, required): The pipeline revision you read.
- `maintenance_policy` (string, one of `when_needed`, `always`, `off`)
- `tunnels` (string, one of `auto`, `on`, `off`)
- `pause_crons` (string, one of `auto`, `off`)
- `run_migrations` (boolean or null): Laravel only; null follows the environment.
- `timeouts` (object): Seconds per stage or line key, at most 3600.
- `keep_node_modules` (boolean)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "binding_id": {
      "description": "Default: the environment's default binding.",
      "minimum": 1,
      "type": "integer"
    },
    "keep_node_modules": {
      "type": "boolean"
    },
    "maintenance_policy": {
      "enum": [
        "when_needed",
        "always",
        "off"
      ],
      "type": "string"
    },
    "pause_crons": {
      "enum": [
        "auto",
        "off"
      ],
      "type": "string"
    },
    "revision": {
      "description": "The pipeline revision you read.",
      "type": "string"
    },
    "run_migrations": {
      "description": "Laravel only; null follows the environment.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    },
    "timeouts": {
      "description": "Seconds per stage or line key, at most 3600.",
      "type": "object"
    },
    "tunnels": {
      "enum": [
        "auto",
        "on",
        "off"
      ],
      "type": "string"
    }
  },
  "required": [
    "site_id",
    "revision"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: the person's role lacks the Edit Environment Deployment Pipeline permission. The message names it and
  says an owner of the company can grant it in Roles; `details.permission` is `editEnvironmentDeploymentPipeline`.
  Nothing is changed.
- `stale`: the pipeline changed since you read it; read it again and resend.
- `pipeline_classic`: Corefinity still runs this binding in its classic form, so it cannot be changed yet.
- `pipeline_locked`: Corefinity has locked this pipeline.
- `maintenance_policy_unavailable`: that maintenance setting is not available for this platform.
- `wrong_platform`: `run_migrations` is for Laravel sites only.
- `timeout_out_of_range`: a timeout is above 3,600 seconds.
- `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.
- 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_deployments_pipeline_settings_update",
  "arguments": {
    "site_id": 4211,
    "revision": "r-8f2c",
    "tunnels": "auto",
    "maintenance_policy": "when_needed"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_deployments_pipeline_settings_update with site_id 4211, revision r-8f2c, tunnels auto, maintenance_policy when_needed. (Update pipeline settings.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [PUT /api/corestack/sites/{site}/deployments/pipeline/{binding}/settings](https://docs.corefinity.com/api/reference/deployments/update-site-deployment-pipeline-settings.md)
- Guide: [Pipeline](https://docs.corefinity.com/guides/sites/code-and-deployments/pipeline-stages.md)
