---
title: "The recipe languages a base offers: version, default, whether the base already has it, and the hosts its install needs"
method: GET
path: "/v1/organizations/{organization_id}/template-languages"
tags: ["Template builds"]
---

# The recipe languages a base offers: version, default, whether the base already has it, and the hosts its install needs

`GET /v1/organizations/{organization_id}/template-languages`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/organizations/{organization_id}/template-languages`
- Auth: HTTP bearer

The language table read for the chain’s platform base of `base`, resolved as a build resolves `recipe.base` (422 validation_failed with details.field "base" and the build’s reasons: base_not_found, base_archived, base_not_published, architecture_not_supported). `included`: the base already has that version (python-node-browser: python and node), so the build installs nothing for it. A version the base has another version of is left out (a build would refuse it with language_conflict). Owners/admins and API keys with a tool permission.

## Path parameters

- `organization_id` string, uuid, required

## Query parameters

- `base` string, required

## Response `200`

Default Response

- TemplateLanguages
  - `base` string, required: `<slug>@<version>` as asked.
  - `platform_base` string, required: The chain’s platform base (the base itself for a platform version): the table is read for it.
  - `apt_hosts` string[], required: Hosts apt installs need while an `auto` build runs (the platform base’s `build_inputs.apt_pin.hosts`, else snapshot.ubuntu.com).
  - `data` object[], required: In table order (python, node, go, rust, java), then newest version first as the table lists them.
    - `id` 'python' | 'node' | 'go' | 'rust' | 'java', required
    - `name` string, required: Display name: Python, Node.js, Go, Rust, Java.
    - `version` string, required: The version as a recipe names it (`{id, version}`): "3.12", "24", "1.27".
    - `default` boolean, required: The version `{id}` without a version resolves to on this base.
    - `included` boolean, required: The base already has this version (its manifest `tools`): the build installs nothing for it and needs no host (python still gets its /opt/venv).
    - `base_version` string, nullable, required: The version the base has (manifest `tools`, a leading v dropped) when included, e.g. "3.12.3".
    - `hosts` string[], required: Hosts its download needs while an `auto` build runs ([] when included, or when it comes from apt).
    - `apt` string[], required: apt packages it installs ([] when included). An `auto` build then also allows `apt_hosts`.

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

[API](https://skmtc.dev/shardflux/apis/shardflux-api.md) · [All operations](https://skmtc.dev/shardflux/apis/shardflux-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shardflux/apis/shardflux-api/revisions/ea685f7b39c4?raw)