Skip to main content
POST
/
v2
/
templates
/
{templateID}
/
builds
/
{buildID}
Start build (v2)
curl --request POST \
  --url https://api.e2b.app/v2/templates/{templateID}/builds/{buildID} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "fromImage": "<string>",
  "fromTemplate": "<string>",
  "fromImageRegistry": {
    "type": "aws",
    "awsAccessKeyId": "<string>",
    "awsSecretAccessKey": "<string>",
    "awsRegion": "<string>"
  },
  "force": false,
  "steps": [],
  "startCmd": "<string>",
  "readyCmd": "<string>"
}
'
{}

Documentation Index

Fetch the complete documentation index at: https://e2b.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
templateID
string
required
​
buildID
string
required

Body

application/json
​
fromImage
string

Image to use as a base for the template build

​
fromTemplate
string

Template to use as a base for the template build

​
fromImageRegistry
object
​
force
boolean
default:false

Whether the whole build should be forced to run regardless of the cache

​
steps
object[]

List of steps to execute in the template build

​
startCmd
string

Start command to execute in the template after the build

​
readyCmd
string

Ready check command to execute in the template after the build

Response

The build has started

Empty response