Skip to main content
GET
/
templates
cURL
curl --request GET \
  --url https://api.e2b.app/templates \
  --header 'X-API-Key: <api-key>'
[
  {
    "templateID": "<string>",
    "buildID": "<string>",
    "cpuCount": 2,
    "memoryMB": 129,
    "diskSizeMB": 1,
    "public": true,
    "aliases": [
      "<string>"
    ],
    "names": [
      "<string>"
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "createdBy": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "<string>"
    },
    "lastSpawnedAt": "2023-11-07T05:31:56Z",
    "spawnCount": 123,
    "buildCount": 123,
    "envdVersion": "<string>",
    "buildStatus": "building"
  }
]

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
teamID
string

Identifier of the team

Response

Successfully returned all templates

​
templateID
string
required

Identifier of the template

​
buildID
string
required

Identifier of the last successful build for given template

​
cpuCount
integer<int32>
required

CPU cores for the sandbox

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

Memory for the sandbox in MiB

Required range: x >= 128
​
diskSizeMB
integer<int32>
required

Disk size for the sandbox in MiB

Required range: x >= 0
​
public
boolean
required

Whether the template is public or only accessible by the team

​
aliases
string[]
required
deprecated

Aliases of the template

​
names
string[]
required

Names of the template (namespace/alias format when namespaced)

​
createdAt
string<date-time>
required

Time when the template was created

​
updatedAt
string<date-time>
required

Time when the template was last updated

​
createdBy
object
required
​
lastSpawnedAt
string<date-time> | null
required

Time when the template was last used

​
spawnCount
integer<int64>
required

Number of times the template was used

​
buildCount
integer<int32>
required

Number of times the template was built

​
envdVersion
string
required

Version of the envd running in the sandbox

​
buildStatus
enum<string>
required

Status of the template build

Available options:
building,
waiting,
ready,
error