---
title: "GetLLMIntegration"
method: POST
path: "/gitpod.v1.RunnerConfigurationService/GetLLMIntegration"
tags: ["gitpod.v1.RunnerConfigurationService"]
---

# GetLLMIntegration

`POST /gitpod.v1.RunnerConfigurationService/GetLLMIntegration`

Gets details about a specific LLM integration.

 Use this method to:
 - View integration settings
 - Check integration status
 - Verify configuration

 ### Examples

 - Get integration details:

   Retrieves information about a specific integration.

   ```yaml
   id: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
   ```

## Request body

- GitpodV1GetLLMIntegrationRequest
  - `id` string, uuid

## Response `200`

Success

- GitpodV1GetLLMIntegrationResponse
  - `integration` GitpodV1LLMIntegration
    - `encryptedApiKey` string, byte — encrypted_api_key is the LLM provider's API key encrypted with the runner's public key.
    - `endpoint` string
    - `id` string — id is the unique identifier of the LLM integration
    - `maxTokens` string — the maximum number of tokens to generate before stopping. 0 is a model default.
    - `models` GitpodV1SupportedModel[] — models represents the supported LLM models for this integration
    - `phase` 'LLM_INTEGRATION_PHASE_UNSPECIFIED' | 'LLM_INTEGRATION_PHASE_AVAILABLE' | 'LLM_INTEGRATION_PHASE_UNAVAILABLE' | 'LLM_INTEGRATION_PHASE_DISABLED' — LLMIntegrationPhase represents the current status/phase of an LLM integration
    - `phaseReason` string — phase_reason provides explanation for the current phase (e.g., "insufficient funds", "user disabled")
    - `requestHeaders` GitpodV1LLMIntegrationRequestHeader[] — request_headers contains optional headers for the LLM integration.
      - `key` string
      - `value` string, byte
    - `runnerId` string

## Other responses

- `default` — Error

## Changes

- **2026-02-11** `b97dcde84128` — 2 warning
  - added the new `SUPPORTED_MODEL_OPUS_4_6` enum value to the `integration/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_6_EXTENDED` enum value to the `integration/models/items/` response property for the response status `200`
- **2025-12-15** `d62ef4b9187c` — 4 warning, 4 info
  - added the new `SUPPORTED_MODEL_OPUS_4_5` enum value to the `integration/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_5_EXTENDED` enum value to the `integration/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_SONNET_4_5` enum value to the `integration/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_SONNET_4_5_EXTENDED` enum value to the `integration/models/items/` response property for the response status `200`
  - …4 more
- **2025-06-10** `ca9a49ac7fbb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.RunnerConfigurationService/GetLLMIntegration/post.md)

---

[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/1923b5d38655/schema)