---
title: "Patch the version"
method: PATCH
path: "/models/{model_id}/versions/{version_id}"
tags: ["version"]
---

# Patch the version

`PATCH /models/{model_id}/versions/{version_id}`

## Path parameters

- `model_id` integer, required
- `version_id` integer, required

## Request body

- Version
  - `id` integer
  - `model_id` integer
  - `mlflow_run_id` string
  - `mlflow_url` string
  - `artifact_uri` string, hostname
  - `endpoints` VersionEndpoint[]
    - `id` string, uuid
    - `version_id` integer
    - `status` 'pending' | 'running' | 'serving' | 'failed' | 'terminated'
    - `url` string, hostname
    - `service_name` string, hostname
    - `environment_name` string
    - `environment` Environment
      - `id` integer
      - `name` string, required
      - `cluster` string
      - `is_default` boolean
      - `region` string
      - `gcp_project` string
      - `default_resource_request` ResourceRequest
        - `min_replica` integer
        - `max_replica` integer
        - `cpu_request` string
        - `memory_request` string
        - `gpu_name` string
        - `gpu_request` string
      - `default_transformer_resource_request` ResourceRequest
        - `min_replica` integer
        - `max_replica` integer
        - `cpu_request` string
        - `memory_request` string
        - `gpu_name` string
        - `gpu_request` string
      - `default_prediction_job_resource_request` PredictionJobResourceRequest
        - `driver_cpu_request` string
        - `driver_memory_request` string
        - `executor_cpu_request` string
        - `executor_memory_request` string
        - `executor_replica` integer
      - `gpus` GPUConfig[]
        - `name` string
        - `values` string[]
        - `resource_type` string
        - `node_selector` object
        - `tolerations` GPUToleration[]
          - `key` string
          - `operator` string
          - `value` string
          - `effect` string
          - `toleration_seconds` integer
        - `min_monthly_cost_per_gpu` number
        - `max_monthly_cost_per_gpu` number
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `monitoring_url` string, hostname
    - `message` string
    - `resource_request` ResourceRequest
      - `min_replica` integer
      - `max_replica` integer
      - `cpu_request` string
      - `memory_request` string
      - `gpu_name` string
      - `gpu_request` string
    - `env_vars` EnvVar[]
      - `name` string
      - `value` string
    - `transformer` Transformer
      - `id` string
      - `enabled` boolean
      - `transformer_type` string
      - `image` string
      - `command` string
      - `args` string
      - `resource_request` ResourceRequest
        - `min_replica` integer
        - `max_replica` integer
        - `cpu_request` string
        - `memory_request` string
        - `gpu_name` string
        - `gpu_request` string
      - `env_vars` EnvVar[]
        - `name` string
        - `value` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `logger` Logger
      - `model` LoggerConfig
        - `enabled` boolean
        - `mode` 'all' | 'request' | 'response'
      - `transformer` LoggerConfig
        - `enabled` boolean
        - `mode` 'all' | 'request' | 'response'
      - `prediction` PredictionLoggerConfig
        - `enabled` boolean
        - `raw_features_table` string
        - `entities_table` string
    - `deployment_mode` 'serverless' | 'raw_deployment'
    - `autoscaling_policy` AutoscalingPolicy
      - `metrics_type` 'concurrency' | 'cpu_utilization' | 'memory_utilization' | 'rps'
      - `target_value` number
    - `protocol` 'HTTP_JSON' | 'UPI_V1'
    - `enable_model_observability` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `properties` object
  - `labels` object
  - `custom_predictor` CustomPredictor
    - `image` string
    - `command` string
    - `args` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `python_version` string

## Response `200`

OK

## Other responses

- `400` — Invalid request format
- `404` — Version with given `version_id` not found

## Changes

- **2023-12-05** `d062ab20ef25` — 1 breaking
  - removed the request body
- **2020-09-28** `c4b3505de7df` — 1 breaking
  - removed the request body

[Change history](https://skmtc.dev/caraml-dev/apis/merlin/changes/models/:model_id/versions/:version_id/patch.md)

---

[API](https://skmtc.dev/caraml-dev/apis/merlin.md) · [All operations](https://skmtc.dev/caraml-dev/apis/merlin/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/caraml-dev/merlin/revisions/d062ab20ef25/schema)