---
title: "UpdateRunner"
method: POST
path: "/gitpod.v1.RunnerService/UpdateRunner"
tags: ["gitpod.v1.RunnerService"]
---

# UpdateRunner

`POST /gitpod.v1.RunnerService/UpdateRunner`

UpdateRunner updates an environment runner.

## Request body

- GitpodV1UpdateRunnerRequest
  - `name` string, nullable — The runner's name which is shown to users
  - `runnerId` string, uuid — runner_id specifies which runner to be updated. +required
  - `spec` GitpodV1UpdateRunnerRequestSpec
    - `configuration` GitpodV1UpdateRunnerRequestRunnerConfiguration
      - `autoUpdate` boolean, nullable — auto_update indicates whether the runner should automatically update itself.
      - `releaseChannel` 'RUNNER_RELEASE_CHANNEL_UNSPECIFIED' | 'RUNNER_RELEASE_CHANNEL_STABLE' | 'RUNNER_RELEASE_CHANNEL_LATEST'
    - `desiredPhase` 'RUNNER_PHASE_UNSPECIFIED' | 'RUNNER_PHASE_CREATED' | 'RUNNER_PHASE_INACTIVE' | 'RUNNER_PHASE_ACTIVE' | 'RUNNER_PHASE_DELETING' | 'RUNNER_PHASE_DELETED' | 'RUNNER_PHASE_DEGRADED' — RunnerPhase represents the phase a runner is in

## Response `200`

Success

- GitpodV1UpdateRunnerResponse

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/27f7bd641de1/schema)