feat: add GET /api/v2/templatebuilder/bases endpoint (#26116)

Implement `GET /api/v2/templatebuilder/bases`, which returns the list of
base templates available in the template builder. Reads from the bundled
catalog by cross-referencing `templatebuilder.BaseTemplateIDs()` with
`examples.List()`, enriching each entry with the OS from the `exampleID
-> OS` map.

The endpoint is gated behind the template builder feature flag (returns
404 when disabled) and requires `policy.ActionRead` on
`rbac.ResourceTemplate`.

Depends on #26115

> [!NOTE]
> This PR was authored by Coder Agents on behalf of @jeremyruppel.
This commit is contained in:
Jeremy Ruppel
2026-06-12 17:40:02 -04:00
committed by GitHub
parent 1215210321
commit 776fbfa748
10 changed files with 405 additions and 3 deletions
+56
View File
@@ -7333,6 +7333,31 @@ const docTemplate = `{
]
}
},
"/api/v2/templatebuilder/bases": {
"get": {
"produces": [
"application/json"
],
"tags": [
"TemplateBuilder"
],
"summary": "List template builder base templates",
"operationId": "list-template-builder-base-templates",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/codersdk.TemplateBuilderBasesResponse"
}
}
},
"security": [
{
"CoderSessionToken": []
}
]
}
},
"/api/v2/templates": {
"get": {
"description": "Returns a list of templates.\nBy default, only non-deprecated templates are returned.\nTo include deprecated templates, specify ` + "`" + `deprecated:true` + "`" + ` in the search query.",
@@ -23597,6 +23622,37 @@ const docTemplate = `{
"$ref": "#/definitions/codersdk.TransitionStats"
}
},
"codersdk.TemplateBuilderBase": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"icon": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"os": {
"type": "string"
}
}
},
"codersdk.TemplateBuilderBasesResponse": {
"type": "object",
"properties": {
"bases": {
"type": "array",
"items": {
"$ref": "#/definitions/codersdk.TemplateBuilderBase"
}
}
}
},
"codersdk.TemplateBuilderConfig": {
"type": "object",
"properties": {