---
title: "Create Template"
method: POST
path: "/templates"
tags: ["Support API Key Authentication"]
---

# Create Template

`POST /templates`

## Request body

- CustomTemplateRequest
  - `name` string
  - `description` string, nullable
  - `docker_image` string, required
  - `docker_image_digest` string
  - `docker_image_tag` string, nullable
  - `category` 'DOCKER' | 'PYTORCH' | 'NVIDIA' | 'TENSOR_FLOW' | 'OPEN_AI' | 'UBUNTU'
  - `volumes` string[]
  - `environment` object
  - `entrypoint` string
  - `internal_ports` integer[]
  - `is_private` boolean
  - `readme` string, nullable
  - `startup_commands` string
  - `container_start_immediately` boolean
  - `health_check_command` string, nullable
  - `docker_credential_id` union
    - string
    - string, uuid
  - `one_time_template` boolean
  - `is_temporary` boolean
  - `docker_image_size` integer, nullable
  - `supports_docker` boolean
  - `supports_volume_encryption` boolean

## Response `200`

Successful Response

- Template
  - `id` string, uuid
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable
  - `name` string, required
  - `description` string, nullable
  - `docker_image` string, required
  - `docker_image_tag` string, required
  - `docker_image_digest` string, nullable, required
  - `docker_image_size` integer, nullable, required
  - `category` 'DOCKER' | 'PYTORCH' | 'NVIDIA' | 'TENSOR_FLOW' | 'OPEN_AI' | 'UBUNTU'
  - `validator_only` boolean, nullable
  - `volumes` string[], nullable, required
  - `environment` object, nullable, required
  - `entrypoint` string, nullable
  - `internal_ports` integer[], nullable, required
  - `user_id` string, uuid, nullable
  - `is_private` boolean, nullable
  - `readme` string, nullable, required
  - `startup_commands` string, nullable
  - `status` string, nullable
  - `is_temporary` boolean, nullable
  - `is_created_from_official_template` boolean, nullable
  - `docker_credential_id` string, uuid, nullable
  - `one_time_template` boolean, nullable
  - `container_start_immediately` boolean, nullable
  - `verify_ssh_connection` boolean, nullable
  - `health_check_command` string, nullable
  - `verification_logs` string, nullable
  - `download_count` integer, nullable
  - `supports_docker` boolean
  - `supports_volume_encryption` boolean
  - `is_archived` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/084c90a2d8cb/schema)