Skip to main content
POST
Create template (v3)

Authorizations

X-API-Key
string
header
required

Body

application/json
name
string

Name of the template. Can include a tag with colon separator (e.g. "my-template" or "my-template:v1"). If tag is included, it will be treated as if the tag was provided in the tags array.

Maximum string length: 128
tags
string[]

Tags to assign to the template build

alias
string
deprecated

Alias of the template. Deprecated, use name instead.

Maximum string length: 128
teamID
string
deprecated

Identifier of the team

cpuCount
integer<int32>

CPU cores for the sandbox

Required range: x >= 1
memoryMB
integer<int32>

Memory for the sandbox in MiB

Required range: x >= 128
minFreeDiskMb
integer<int32>

Requested minimum free space after the template's build steps, in MiB. Omit to use the team's default. Set to 0 to request no minimum free-disk growth. The filesystem is never shrunk, including inherited or already-larger filesystems. Growth is best effort, so filesystem metadata can leave the available space slightly below the requested minimum.

Required range: x >= 0

Response

The build was requested successfully

templateID
string
required

Identifier of the template

buildID
string
required

Identifier of the last successful build for given template

public
boolean
required

Whether the template is public or only accessible by the team

names
string[]
required

Names of the template

tags
string[]
required

Tags assigned to the template build

aliases
string[]
required
deprecated

Aliases of the template