---
title: "List scaffold templates"
method: GET
path: "/scaffold-templates"
tags: ["ScaffoldTemplates"]
---

# List scaffold templates

`GET /scaffold-templates`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/scaffold-templates`
- Auth: HTTP bearer

Returns every scaffold template registered in the calling token's org, sorted by name. Templates power the in-app 'New from template' wizard and the equivalent Terraform / CLI scaffolders. Registration and deletion are intentionally not on /v1 — they go through admin callables to keep GitHub repo coords out of declarative IaC.

## Response `200`

List of scaffold templates

- object
  - `templates` ScaffoldTemplate[]
    - `id` string, required
    - `name` string, nullable
    - `description` string, nullable
    - `tags` string[]
    - `templateRepo` object
      - `owner` string, nullable
      - `repo` string, nullable
    - `targetEntityKind` 'component' | 'api' | 'resource' | 'system' | 'domain', nullable
    - `parameters` ScaffoldParam[]
      - `key` string, required
      - `label` string, required
      - `type` 'string' | 'enum' | 'team' | 'boolean', required
      - `required` boolean
      - `default` string, nullable
      - `helpText` string, nullable
      - `options` string[], nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `401` (unresolved $ref)

---

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