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

# ListLLMIntegrations

`POST /gitpod.v1.RunnerConfigurationService/ListLLMIntegrations`

Lists LLM integrations for a runner.

 Use this method to:
 - View all integrations
 - Monitor integration status
 - Check available LLMs

 ### Examples

 - List integrations:

   Shows all LLM integrations.

   ```yaml
   filter:
     runnerIds: ["d2c94c27-3b76-4a42-b88c-95a85e392c68"]
   pagination:
     pageSize: 20
   ```

## Query parameters

- `pageSize` integer
- `token` string

## Request body

- GitpodV1ListLLMIntegrationsRequest
  - `filter` GitpodV1ListLLMIntegrationsRequestFilter
    - `runnerIds` string[] — runner_ids filters the response to only LLM integrations of these Runner IDs
  - `pagination` GitpodV1PaginationRequest
    - `pageSize` integer — Page size is the maximum number of results to retrieve per page. Defaults to 25. Maximum 100.
    - `token` string — Token for the next set of results that was returned as next_token of a PaginationResponse

## Response `200`

Success

- GitpodV1ListLLMIntegrationsResponse
  - `integrations` GitpodV1LLMIntegration[]
    - `codexConfiguration` GitpodV1LLMIntegrationCodexConfiguration — LLMIntegrationCodexConfiguration contains Codex-specific model aliases for an LLM integration.
      - `modelMappings` GitpodV1LLMIntegrationCodexConfigurationModelMapping[]
        - `model` 'CODEX_OPEN_AI_MODEL_UNSPECIFIED' | 'CODEX_OPEN_AI_MODEL_GPT_5_5' | 'CODEX_OPEN_AI_MODEL_GPT_5_4' | 'CODEX_OPEN_AI_MODEL_GPT_5_4_MINI' | 'CODEX_OPEN_AI_MODEL_GPT_5_3_CODEX' | 'CODEX_OPEN_AI_MODEL_GPT_5_3_CODEX_SPARK' | 'CODEX_OPEN_AI_MODEL_GPT_5_2' | 'CODEX_OPEN_AI_MODEL_GPT_5_6_SOL' | 'CODEX_OPEN_AI_MODEL_GPT_5_6_TERRA' | 'CODEX_OPEN_AI_MODEL_GPT_5_6_LUNA' — CodexOpenAIModel is the static allowlist of concrete OpenAI models that the Codex app runtime can select through Ona's Codex picker.
        - `providerModel` string — provider_model is the exact model identifier expected by the upstream integration.
    - `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")
    - `provider` 'LLM_PROVIDER_UNSPECIFIED' | 'LLM_PROVIDER_ANTHROPIC' | 'LLM_PROVIDER_OPENAI'
    - `requestHeaders` GitpodV1LLMIntegrationRequestHeader[] — request_headers contains optional headers for the LLM integration.
      - `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
    - `runnerId` string
    - `tokenSource` 'LLM_TOKEN_SOURCE_UNSPECIFIED' | 'LLM_TOKEN_SOURCE_DIRECT_API' | 'LLM_TOKEN_SOURCE_BEDROCK' | 'LLM_TOKEN_SOURCE_BEDROCK_MANTLE' | 'LLM_TOKEN_SOURCE_VERTEX_AI' — LLMTokenSource identifies how an LLM integration obtains model access. It is independent from LLMProvider, which identifies the model family.
  - `llmManagedByOna` boolean — Deprecated: Use ona_intelligence_providers together with LLMIntegration.provider instead.
  - `onaIntelligenceProviders` GitpodV1LLMProvider[] — ona_intelligence_providers lists the provider families governed by Ona Intelligence for the organization that owns the requested runner.
  - `pagination` GitpodV1PaginationResponse
    - `nextToken` string — Token passed for retrieving the next set of results. Empty if there are no more results

## Other responses

- `default` — Error

## Changes

- **2026-07-30** `44d50c2ac284` — 4 warning, 6 info
  - added the new `SUPPORTED_MODEL_OPENAI_AUTO` enum value to the `integrations/items/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_7` enum value to the `integrations/items/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_8` enum value to the `integrations/items/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_SONNET_5` enum value to the `integrations/items/models/items/` response property for the response status `200`
  - …6 more
- **2026-04-02** `dabc0ff98cd7` — 3 warning
  - added the new `SUPPORTED_MODEL_HAIKU_4_5` enum value to the `integrations/items/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_SONNET_4_6` enum value to the `integrations/items/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_SONNET_4_6_EXTENDED` enum value to the `integrations/items/models/items/` response property for the response status `200`
- **2026-02-11** `b97dcde84128` — 2 warning
  - added the new `SUPPORTED_MODEL_OPUS_4_6` enum value to the `integrations/items/models/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_6_EXTENDED` enum value to the `integrations/items/models/items/` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.RunnerConfigurationService/ListLLMIntegrations/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/44d50c2ac284/schema)