# Build request to migrate deployment to a different template

**GET /deployments/{deployment_id}/migrate_template**

Returns a deployment update request that would migrate this deployment to a different template.


## Servers
- https://api.elastic-cloud.com/api/v1: https://api.elastic-cloud.com/api/v1 ()



## Parameters

### Path parameters
- **deployment_id** (string)
  Identifier for the Deployment

### Query parameters
- **template_id** (string)
  The ID of the deployment template to migrate to
- **skip_instance_metrics_check** (boolean)
  If true, will skip the instance metrics check for memory and disk usage calculations


## Responses
### 200
The request was valid and the deployment can be migrated to the template with the provided ID.

#### Body: application/json (object)
- **name** (string)
  A new name for the deployment, otherwise stays the same.
- **prune_orphans** (boolean)
  Whether or not to prune orphan resources that are no longer mentioned in this request. Note that resourcesare tracked by ref_id, and if a resource's ref_id is changed, any previous running resources created with that previousref_id are considered to be orphaned as well.
- **resources** (object)
  Describes the Deployment resource updates
- **settings** (object)
  Additional configuration for the new deployment object.
- **metadata** (object)
  Additional information about the current deployment object.
- **alias** (string)
  A user-defined alias to use in place of Cluster IDs for user-friendly URLs

### 400
The deployment cannot be successfully migrated to the template with the provided ID.

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 401
You are not authorized to perform this action.

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 404
The Deployment specified by {deployment_id} cannot be found. (code: `deployments.deployment_not_found`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request


[Powered by Bump.sh](https://bump.sh)