---
title: "GetRunnerConfiguration"
method: POST
path: "/gitpod.v1.RunnerInteractionService/GetRunnerConfiguration"
tags: ["gitpod.v1.RunnerInteractionService"]
---

# GetRunnerConfiguration

`POST /gitpod.v1.RunnerInteractionService/GetRunnerConfiguration`

## Request body

- GitpodV1GetRunnerConfigurationRequest
  - `runnerId` string, uuid

## Response `200`

Success

- GitpodV1GetRunnerConfigurationResponse
  - `configuration` GitpodV1GetRunnerConfigurationResponseRunnerConfiguration
    - `autoUpdate` boolean
    - `continuousProfiling` boolean — continuous_profiling indicates whether continuous profiling is enabled.
    - `devcontainerImageCacheEnabled` boolean
    - `encryptedHoneycombApiKey` string, byte — encrypted_honeycomb_api_key is the Honeycomb API key encrypted with the runner's public key.
    - `logLevel` 'LOG_LEVEL_UNSPECIFIED' | 'LOG_LEVEL_DEBUG' | 'LOG_LEVEL_INFO' | 'LOG_LEVEL_WARN' | 'LOG_LEVEL_ERROR'
    - `metrics` GitpodV1RunnerMetricsConfiguration
      - `enabled` boolean
      - `encryptedPassword` string, byte
      - `encryptedUsername` string, byte
      - `includeVerboseMetrics` boolean — When true, the runner also forwards verbose metrics (e.g. aws_sdk_go_*) via the managed metrics pipeline. Disabled by default to control metrics volume.
      - `managedMetricsEnabled` boolean — When true, the runner pushes metrics to the management plane via ReportRunnerMetrics instead of directly to the remote_write endpoint.
      - `url` string
    - `region` string
    - `releaseChannel` 'RUNNER_RELEASE_CHANNEL_UNSPECIFIED' | 'RUNNER_RELEASE_CHANNEL_STABLE' | 'RUNNER_RELEASE_CHANNEL_LATEST'
    - `updateWindow` GitpodV1UpdateWindow — UpdateWindow defines a daily time window (UTC) during which auto-updates are allowed. The window must be at least 2 hours long. Overnight windows are supported (e.g., start_hour=22, end_hour=4).
      - `endHour` integer, nullable — end_hour is the end of the update window as a UTC hour (0-23). If not set, defaults to start_hour + 2.
      - `startHour` integer, nullable — start_hour is the beginning of the update window as a UTC hour (0-23). +required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.net/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/versions/44d50c2ac284/schema)