Start build (v2)

Start the build

POST /v2/templates/{templateID}/builds/{buildID}

Start build (v2)

cURL

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>"
}
'

202

{}

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

Option 1

Option 2

Option 3

Show child attributes

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

Show child attributes

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

202

application/json

The build has started

Empty response