---
title: "UpdateRunnerManager"
method: POST
path: "/gitpod.v1.RunnerManagerService/UpdateRunnerManager"
tags: ["gitpod.v1.RunnerManagerService"]
---

# UpdateRunnerManager

`POST /gitpod.v1.RunnerManagerService/UpdateRunnerManager`

## Request body

- GitpodV1UpdateRunnerManagerRequest
  - `name` string, nullable — The runner manager's name which is shown to users
  - `region` string, nullable — Region where the runner manager operates
  - `runnerManagerId` string, uuid — runner_manager_id specifies which runner manager to be updated. +required
  - `spec` GitpodV1UpdateRunnerManagerRequestSpec
    - `configuration` GitpodV1UpdateRunnerManagerRequestRunnerManagerConfiguration
      - `collectDebugProfile` boolean, nullable — When set to true, triggers a one-shot profile collection that uploads pprof profiles to the logs S3 bucket.
      - `llmIntegrationTemplatesUpdate` GitpodV1UpdateRunnerManagerRequestRunnerManagerConfigurationStaticLLMIntegrationsUpdate
        - `llmIntegrationTemplates` GitpodV1StaticLLMIntegration[]
          - `encryptedApiKey` string, byte — encrypted_api_key is the LLM provider's API key encrypted with the runner's public key.
          - `endpoint` string
          - `id` string, uuid — id is a unique identifier for the LLM integration template. This field must be provided by the client when creating the integration. It is required for identifying and updating the integration, since there is no other unique identifier.
          - `maxTokens` string — max_tokens is the maximum number of tokens to generate before stopping. 0 is a model default.
          - `models` GitpodV1SupportedModel[] — models represents the LLM models this integration supports
          - `requestHeaders` GitpodV1LLMIntegrationRequestHeader[] — request_headers contains custom request headers for this integration (e.g., for portkey compatibility). Header values will be encrypted with the runner's public key.
            - `headerType` 'LLM_INTEGRATION_REQUEST_HEADER_TYPE_UNSPECIFIED' | 'LLM_INTEGRATION_REQUEST_HEADER_TYPE_LITERAL' | 'LLM_INTEGRATION_REQUEST_HEADER_TYPE_CEL_EXPRESSION' — LLMIntegrationRequestHeaderType describes how an LLM integration request header value is resolved.
            - `key` string
            - `value` string, byte
      - `logLevel` 'LOG_LEVEL_UNSPECIFIED' | 'LOG_LEVEL_DEBUG' | 'LOG_LEVEL_INFO' | 'LOG_LEVEL_WARN' | 'LOG_LEVEL_ERROR'
      - `metrics` GitpodV1UpdateRunnerManagerRequestRunnerManagerMetricsConfiguration
        - `enabled` boolean, nullable — enabled indicates whether the runner manager should collect metrics
        - `password` string, nullable — password is the password to use for the metrics collector
        - `url` string, nullable — url is the URL of the metrics collector
        - `username` string, nullable — username is the username to use for the metrics collector
      - `releaseChannel` 'RUNNER_MANAGER_RELEASE_CHANNEL_UNSPECIFIED' | 'RUNNER_MANAGER_RELEASE_CHANNEL_STABLE' | 'RUNNER_MANAGER_RELEASE_CHANNEL_LATEST'
      - `scmIntegrationTemplatesUpdate` GitpodV1UpdateRunnerManagerRequestRunnerManagerConfigurationStaticSCMIntegrationsUpdate
        - `scmIntegrationTemplates` GitpodV1StaticSCMIntegration[]
          - `host` string
          - `oauth` GitpodV1SCMIntegrationOAuthConfig
            - `clientId` string — client_id is the OAuth app's client ID in clear text.
            - `encryptedClientSecret` string, byte — encrypted_client_secret is the OAuth app's secret encrypted with the runner's public key.
            - `issuerUrl` string — issuer_url is used to override the authentication provider URL, if it doesn't match the SCM host. +optional if not set, this account is owned by the installation.
          - `pat` boolean
          - `scmId` string
          - `virtualDirectory` string, nullable — virtual_directory is the virtual directory path for Azure DevOps Server (e.g., "/tfs"). This field is only used for Azure DevOps Server SCM integrations and should be empty for other SCM types. Azure DevOps Server APIs work without collection when PAT scope is 'All accessible organizations'.
    - `desiredPhase` 'RUNNER_MANAGER_PHASE_UNSPECIFIED' | 'RUNNER_MANAGER_PHASE_CREATED' | 'RUNNER_MANAGER_PHASE_ENABLED' | 'RUNNER_MANAGER_PHASE_DISABLED'

## Response `200`

Success

- GitpodV1UpdateRunnerManagerResponse

## 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/revisions/44d50c2ac284/schema)