---
title: "List stacks"
method: GET
path: "/stacks"
tags: ["stacks"]
---

# List stacks

`GET /stacks`

Retrieves all stack metadata

## Response `200`

OK: List of stacks.

- ModelStack[]
  - `CreatedAt` string
  - `Description` string — optional; empty means "unset" (never overwrites a stored description)
  - `ID` string
  - `Label` string
  - `Policies` array[] — Inline policies from PKL
    - integer[]

## Other responses

- `404` — Not Found: No stacks found.
- `500` — Internal Server Error.

## Changes

- **2026-02-06** `d39213f36543` — 1 info
  - endpoint added
- **2025-10-21** `fb06d951574c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/platform-engineering-labs/apis/formae-rest-api/changes/stacks/get.md)

---

[API](https://skmtc.dev/platform-engineering-labs/apis/formae-rest-api.md) · [All operations](https://skmtc.dev/platform-engineering-labs/apis/formae-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/platform-engineering-labs/formae-rest-api/revisions/3172614a653b/schema)
