Create a new template

POST

templates

curl --request POST \
  --url https://rest.runpod.io/v1/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "imageName": "<string>",
  "name": "<string>",
  "category": "NVIDIA",
  "containerDiskInGb": 50,
  "containerRegistryAuthId": "<string>",
  "dockerEntrypoint": [],
  "dockerStartCmd": [],
  "env": {
    "ENV_VAR": "value"
  },
  "isPublic": false,
  "isServerless": false,
  "ports": [
    "8888/http",
    "22/tcp"
  ],
  "readme": "",
  "volumeInGb": 20,
  "volumeMountPath": "/workspace"
}
'

import requests

url = "https://rest.runpod.io/v1/templates"

payload = {
    "imageName": "<string>",
    "name": "<string>",
    "category": "NVIDIA",
    "containerDiskInGb": 50,
    "containerRegistryAuthId": "<string>",
    "dockerEntrypoint": [],
    "dockerStartCmd": [],
    "env": { "ENV_VAR": "value" },
    "isPublic": False,
    "isServerless": False,
    "ports": ["8888/http", "22/tcp"],
    "readme": "",
    "volumeInGb": 20,
    "volumeMountPath": "/workspace"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    imageName: '<string>',
    name: '<string>',
    category: 'NVIDIA',
    containerDiskInGb: 50,
    containerRegistryAuthId: '<string>',
    dockerEntrypoint: [],
    dockerStartCmd: [],
    env: {ENV_VAR: 'value'},
    isPublic: false,
    isServerless: false,
    ports: ['8888/http', '22/tcp'],
    readme: '',
    volumeInGb: 20,
    volumeMountPath: '/workspace'
  })
};

fetch('https://rest.runpod.io/v1/templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rest.runpod.io/v1/templates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'imageName' => '<string>',
    'name' => '<string>',
    'category' => 'NVIDIA',
    'containerDiskInGb' => 50,
    'containerRegistryAuthId' => '<string>',
    'dockerEntrypoint' => [
        
    ],
    'dockerStartCmd' => [
        
    ],
    'env' => [
        'ENV_VAR' => 'value'
    ],
    'isPublic' => false,
    'isServerless' => false,
    'ports' => [
        '8888/http',
        '22/tcp'
    ],
    'readme' => '',
    'volumeInGb' => 20,
    'volumeMountPath' => '/workspace'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://rest.runpod.io/v1/templates"

	payload := strings.NewReader("{\n  \"imageName\": \"<string>\",\n  \"name\": \"<string>\",\n  \"category\": \"NVIDIA\",\n  \"containerDiskInGb\": 50,\n  \"containerRegistryAuthId\": \"<string>\",\n  \"dockerEntrypoint\": [],\n  \"dockerStartCmd\": [],\n  \"env\": {\n    \"ENV_VAR\": \"value\"\n  },\n  \"isPublic\": false,\n  \"isServerless\": false,\n  \"ports\": [\n    \"8888/http\",\n    \"22/tcp\"\n  ],\n  \"readme\": \"\",\n  \"volumeInGb\": 20,\n  \"volumeMountPath\": \"/workspace\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://rest.runpod.io/v1/templates")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"imageName\": \"<string>\",\n  \"name\": \"<string>\",\n  \"category\": \"NVIDIA\",\n  \"containerDiskInGb\": 50,\n  \"containerRegistryAuthId\": \"<string>\",\n  \"dockerEntrypoint\": [],\n  \"dockerStartCmd\": [],\n  \"env\": {\n    \"ENV_VAR\": \"value\"\n  },\n  \"isPublic\": false,\n  \"isServerless\": false,\n  \"ports\": [\n    \"8888/http\",\n    \"22/tcp\"\n  ],\n  \"readme\": \"\",\n  \"volumeInGb\": 20,\n  \"volumeMountPath\": \"/workspace\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://rest.runpod.io/v1/templates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"imageName\": \"<string>\",\n  \"name\": \"<string>\",\n  \"category\": \"NVIDIA\",\n  \"containerDiskInGb\": 50,\n  \"containerRegistryAuthId\": \"<string>\",\n  \"dockerEntrypoint\": [],\n  \"dockerStartCmd\": [],\n  \"env\": {\n    \"ENV_VAR\": \"value\"\n  },\n  \"isPublic\": false,\n  \"isServerless\": false,\n  \"ports\": [\n    \"8888/http\",\n    \"22/tcp\"\n  ],\n  \"readme\": \"\",\n  \"volumeInGb\": 20,\n  \"volumeMountPath\": \"/workspace\"\n}"

response = http.request(request)
puts response.read_body

{
  "category": "NVIDIA",
  "containerDiskInGb": 50,
  "containerRegistryAuthId": "<string>",
  "dockerEntrypoint": [],
  "dockerStartCmd": [],
  "earned": 100,
  "env": {
    "ENV_VAR": "value"
  },
  "id": "30zmvf89kd",
  "imageName": "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04",
  "isPublic": false,
  "isRunpod": true,
  "isServerless": true,
  "name": "my template",
  "ports": [
    "8888/http",
    "22/tcp"
  ],
  "readme": "<string>",
  "runtimeInMin": 123,
  "volumeInGb": 20,
  "volumeMountPath": "/workspace"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a new template.

imageName

string

required

Docker image name.

name

string

required

Template name.

Response

Successful operation.

category

string

The category of the template. The category can be used to filter templates in the Runpod UI. Current categories are NVIDIA, AMD, and CPU.

Example:

"NVIDIA"

containerDiskInGb

integer

The amount of disk space, in gigabytes (GB), to allocate on the container disk for a Pod or worker. The data on the container disk is wiped when the Pod or worker restarts. To persist data across restarts, set volumeInGb to configure the local network volume.

Example:

50

containerRegistryAuthId

string

dockerEntrypoint

string[]

If specified, overrides the ENTRYPOINT for the Docker image run on a Pod or worker. If [], uses the ENTRYPOINT defined in the image.

Example:

[]

dockerStartCmd

string[]

If specified, overrides the start CMD for the Docker image run on a Pod or worker. If [], uses the start CMD defined in the image.

Example:

[]

earned

number

The amount of Runpod credits earned by the creator of a template by all Pods or workers created from the template.

Example:

100

env

object

Example:

{ "ENV_VAR": "value" }

string

A unique string identifying a template.

Example:

"30zmvf89kd"

imageName

string

The image tag for the container run on Pods or workers created from a template.

Example:

"runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04"

isPublic

boolean

Set to true if a template is public and can be used by any Runpod user. Set to false if a template is private and can only be used by the creator.

Example:

false

isRunpod

boolean

If true, a template is an official template managed by Runpod.

Example:

true

isServerless

boolean

If true, instances created from a template are Serverless workers. If false, instances created from a template are Pods.

Example:

true

name

string

A user-defined name for a template. The name needs to be unique.

Example:

"my template"

ports

string[]

A list of ports exposed on a Pod or worker. Each port is formatted as [port number]/[protocol]. Protocol can be either http or tcp.

Example:

["8888/http", "22/tcp"]

readme

string

A string of markdown-formatted text that describes a template. The readme is displayed in the Runpod UI when a user selects the template.

runtimeInMin

integer

volumeInGb

integer

The amount of disk space, in gigabytes (GB), to allocate on the local network volume for a Pod or worker. The data on the local network volume is persisted across restarts. To persist data so that future Pods and workers can access it, create a network volume and set networkVolumeId to attach it to the Pod or worker.

Example:

20

volumeMountPath

string

If a local network volume or network volume is attached to a Pod or worker, the absolute path where the network volume is mounted in the filesystem.

Example:

"/workspace"

Last modified on October 5, 2026

Create a new template

curl --request POST \
  --url https://rest.runpod.io/v1/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "imageName": "<string>",
  "name": "<string>",
  "category": "NVIDIA",
  "containerDiskInGb": 50,
  "containerRegistryAuthId": "<string>",
  "dockerEntrypoint": [],
  "dockerStartCmd": [],
  "env": {
    "ENV_VAR": "value"
  },
  "isPublic": false,
  "isServerless": false,
  "ports": [
    "8888/http",
    "22/tcp"
  ],
  "readme": "",
  "volumeInGb": 20,
  "volumeMountPath": "/workspace"
}
'

import requests

url = "https://rest.runpod.io/v1/templates"

payload = {
    "imageName": "<string>",
    "name": "<string>",
    "category": "NVIDIA",
    "containerDiskInGb": 50,
    "containerRegistryAuthId": "<string>",
    "dockerEntrypoint": [],
    "dockerStartCmd": [],
    "env": { "ENV_VAR": "value" },
    "isPublic": False,
    "isServerless": False,
    "ports": ["8888/http", "22/tcp"],
    "readme": "",
    "volumeInGb": 20,
    "volumeMountPath": "/workspace"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    imageName: '<string>',
    name: '<string>',
    category: 'NVIDIA',
    containerDiskInGb: 50,
    containerRegistryAuthId: '<string>',
    dockerEntrypoint: [],
    dockerStartCmd: [],
    env: {ENV_VAR: 'value'},
    isPublic: false,
    isServerless: false,
    ports: ['8888/http', '22/tcp'],
    readme: '',
    volumeInGb: 20,
    volumeMountPath: '/workspace'
  })
};

fetch('https://rest.runpod.io/v1/templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rest.runpod.io/v1/templates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'imageName' => '<string>',
    'name' => '<string>',
    'category' => 'NVIDIA',
    'containerDiskInGb' => 50,
    'containerRegistryAuthId' => '<string>',
    'dockerEntrypoint' => [
        
    ],
    'dockerStartCmd' => [
        
    ],
    'env' => [
        'ENV_VAR' => 'value'
    ],
    'isPublic' => false,
    'isServerless' => false,
    'ports' => [
        '8888/http',
        '22/tcp'
    ],
    'readme' => '',
    'volumeInGb' => 20,
    'volumeMountPath' => '/workspace'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://rest.runpod.io/v1/templates"

	payload := strings.NewReader("{\n  \"imageName\": \"<string>\",\n  \"name\": \"<string>\",\n  \"category\": \"NVIDIA\",\n  \"containerDiskInGb\": 50,\n  \"containerRegistryAuthId\": \"<string>\",\n  \"dockerEntrypoint\": [],\n  \"dockerStartCmd\": [],\n  \"env\": {\n    \"ENV_VAR\": \"value\"\n  },\n  \"isPublic\": false,\n  \"isServerless\": false,\n  \"ports\": [\n    \"8888/http\",\n    \"22/tcp\"\n  ],\n  \"readme\": \"\",\n  \"volumeInGb\": 20,\n  \"volumeMountPath\": \"/workspace\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://rest.runpod.io/v1/templates")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"imageName\": \"<string>\",\n  \"name\": \"<string>\",\n  \"category\": \"NVIDIA\",\n  \"containerDiskInGb\": 50,\n  \"containerRegistryAuthId\": \"<string>\",\n  \"dockerEntrypoint\": [],\n  \"dockerStartCmd\": [],\n  \"env\": {\n    \"ENV_VAR\": \"value\"\n  },\n  \"isPublic\": false,\n  \"isServerless\": false,\n  \"ports\": [\n    \"8888/http\",\n    \"22/tcp\"\n  ],\n  \"readme\": \"\",\n  \"volumeInGb\": 20,\n  \"volumeMountPath\": \"/workspace\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://rest.runpod.io/v1/templates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"imageName\": \"<string>\",\n  \"name\": \"<string>\",\n  \"category\": \"NVIDIA\",\n  \"containerDiskInGb\": 50,\n  \"containerRegistryAuthId\": \"<string>\",\n  \"dockerEntrypoint\": [],\n  \"dockerStartCmd\": [],\n  \"env\": {\n    \"ENV_VAR\": \"value\"\n  },\n  \"isPublic\": false,\n  \"isServerless\": false,\n  \"ports\": [\n    \"8888/http\",\n    \"22/tcp\"\n  ],\n  \"readme\": \"\",\n  \"volumeInGb\": 20,\n  \"volumeMountPath\": \"/workspace\"\n}"

response = http.request(request)
puts response.read_body

{
  "category": "NVIDIA",
  "containerDiskInGb": 50,
  "containerRegistryAuthId": "<string>",
  "dockerEntrypoint": [],
  "dockerStartCmd": [],
  "earned": 100,
  "env": {
    "ENV_VAR": "value"
  },
  "id": "30zmvf89kd",
  "imageName": "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04",
  "isPublic": false,
  "isRunpod": true,
  "isServerless": true,
  "name": "my template",
  "ports": [
    "8888/http",
    "22/tcp"
  ],
  "readme": "<string>",
  "runtimeInMin": 123,
  "volumeInGb": 20,
  "volumeMountPath": "/workspace"
}

API v1

Pods

Serverless

Network volumes

Templates

Container registry auth

Billing

Authorizations

Body

Response