---
title: "List Component Bundles"
method: GET
path: "/versions/bundles"
tags: ["versions"]
---

# List Component Bundles

`GET /versions/bundles`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/versions/bundles`
- Auth: none declared

Get available component bundles from GitLab tags.

Component bundles are git tags in the mengi-cluster-apps repository.
This endpoint queries GitLab API and caches results for 5 minutes.

## Query parameters

- `stable_only` boolean: Only return stable bundles

## Response `200`

Successful Response

- ComponentBundleListResponse: List of component bundles.
  - `bundles` ComponentBundleResponse[], required
    - `version` string, required
    - `git_tag` string, required
    - `display_name` string, nullable
    - `release_notes` string, nullable
    - `is_stable` boolean
    - `is_latest` boolean
    - `created_at` string, date-time, nullable
    - `description` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/4ae9b375cdbb?raw)
