---
title: "Create template (v3)"
method: POST
path: "/v3/templates"
tags: ["templates"]
---

# Create template (v3)

`POST /v3/templates`

Create a new template

## Request body

- TemplateBuildRequestV3
  - `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.
  - `tags` string[] — Tags to assign to the template build
  - `alias` string — Alias of the template. Deprecated, use name instead.
  - `teamID` string — Identifier of the team
  - `cpuCount` integer — CPU cores for the sandbox
  - `memoryMB` integer — Memory for the sandbox in MiB

## Response `202`

The build was requested successfully

- TemplateRequestResponseV3
  - `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 — Aliases of the template

## Other responses

- `400` — Bad request
- `401` — Authentication error
- `403` — Forbidden
- `500` — Server error

## Changes

- **2026-08-20** `e01b3f5506fe` — 4 info
  - added the optional property `error_code` to the response with the `400` status
  - added the optional property `error_code` to the response with the `401` status
  - added the optional property `error_code` to the response with the `403` status
  - added the optional property `error_code` to the response with the `500` status
- **2026-07-24** `93ed246a4c10` — 2 warning, 2 info
  - the `alias` request property's maxLength was set to `128`
  - the `name` request property's maxLength was set to `128`
  - the endpoint scheme security `AdminApiKeyAuth AND AdminTeamAuth` was added to the API
  - the endpoint scheme security `Supabase1TokenAuth AND Supabase2TeamAuth` was removed from the API
- **2026-05-27** `e13ef89d456c` — 2 info
  - the endpoint scheme security `AuthProviderBearerAuth AND AuthProviderTeamAuth` was added to the API
  - added the non-success response with the status `403`
- **2026-01-27** `05ac348d449f` — 1 warning, 8 info
  - removed the request property `names`
  - the endpoint scheme security `Supabase1TokenAuth AND Supabase2TeamAuth` was added to the API
  - the endpoint scheme security `Supabase1TokenAuth` was removed from the API
  - added the new optional request property `name`
  - …5 more
- **2026-01-12** `83a3cddc628f` — 3 info
  - added the new optional request property `names`
  - the request property `alias` became optional
  - request property `alias` deprecated

[Full history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/v3/templates/post.md)

---

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