---
title: "List OS templates"
method: GET
path: "/v1/vps/{service_id}/os-templates"
tags: ["VPS"]
---

# List OS templates

`GET /v1/vps/{service_id}/os-templates`

## Request

- Base URL: `https://developers.servera.co.uk`
- URL: `https://developers.servera.co.uk/v1/vps/{service_id}/os-templates`
- Auth: HTTP bearer

The OS images you can reinstall this VPS/VDS with (respects per-service access).

Each item has an `id` and a human `label` - pick the one you want and pass its
`id` to `POST /reinstall` as `template_id`. `type` is the machine's
virtualization type (`qemu` or `lxc`); the list is already filtered to what's
installable on it.

## Path parameters

- `service_id` integer, required

## Response `200`

Successful Response

- OsTemplateList
  - `templates` OsTemplate[], required
    - `id` integer, required
    - `label` string, required
    - `os_family` string, required
    - `icon_url` string, nullable
  - `type` string, required

## Other responses

- `422`: Validation Error

---

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