---
title: "List available Runtime Image variants"
method: GET
path: "/v2/images"
tags: ["Runtimes"]
---

# List available Runtime Image variants

`GET /v2/images`

## Request

- Base URL: `https://api.runta.com`
- URL: `https://api.runta.com/v2/images`
- Auth: HTTP bearer

## Response `200`

List response envelope.

- ListRuntimeImagesResponse: List response envelope.
  - `data` RuntimeImage[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `icon_key` string, required
    - `architectures` string[], required
    - `disk` RuntimeImageDiskCapability, required
      - `minimum_gib` integer, required
      - `maximum_gib` integer, required
      - `default_gib` integer, required
      - `step_gib` integer, required
    - `recommended_resources` RuntimeImageRecommendedResources, required
      - `vcpus` integer, required
      - `memory_mib` integer, required
    - `is_default` boolean, required
    - `is_custom` boolean, required
    - `created_at` string, date-time
    - `model_provider` RuntimeImageModelProvider
      - `protocol_bindings` RuntimeImageProtocolBinding[], required: How each protocol this image speaks reaches a provider.
        - `protocol` string, required
        - `environment_variable` string, required: Guest variable this image's onboarding writes the credential to.
        - `base_url` string, required: Endpoint the onboarding configures when the caller names none.
      - `subscription_options` RuntimeImageSubscriptionOption[], required: Subscription credentials that Runta obtains for the tenant. Empty if this image accepts only tenant-supplied credentials.
        - `protocols` string[], required
        - `secret_preset_ids` string[], required
      - `allow_custom_base_url` boolean, required: Whether this image's agent can be pointed at another endpoint.
      - `allow_runtime_sign_in` boolean, required
    - `web_ui` RuntimeImageWebUi: A browser surface the image serves. It is published through the runtime's ingress on demand, behind a session gateway, rather than being exposed for the lifetime of the runtime.
      - `port` integer, required: Guest-local port the gateway listens on.
    - `exposed_ports` integer[], required: TCP ports declared by the image. They are discovery hints and are not published automatically.

## Other responses

- `401`: Missing, malformed, or rejected bearer token
- `403`: The bearer token is not allowed to perform this action
- `404`: The requested resource was not found
- `409`: The request conflicts with current resource state
- `422`: Validation or application error
- `429`: Rate limit exceeded
- `501`: Operation is not implemented
- `503`: Upstream service is unavailable
- `504`: Upstream request timed out
- `default`: Error response

## Changes

- **2026-11-05** `fb5a0ecd3fc2`: 20 warning
  - added the new `FEATURE_TEMPORARILY_DISABLED` enum value to the `error/code` response property for the response status `401`
  - added the new `FEATURE_TEMPORARILY_DISABLED` enum value to the `error/code` response property for the response status `403`
  - added the new `FEATURE_TEMPORARILY_DISABLED` enum value to the `error/code` response property for the response status `404`
  - added the new `FEATURE_TEMPORARILY_DISABLED` enum value to the `error/code` response property for the response status `409`
  - …16 more

[Operation history](https://skmtc.dev/runta/apis/runta-public-rest-api/changes/v2/images/get.md)

---

[API](https://skmtc.dev/runta/apis/runta-public-rest-api.md) - [All operations](https://skmtc.dev/runta/apis/runta-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runta/apis/runta-public-rest-api/revisions/fb5a0ecd3fc2?raw)