POST
/
v1
/
blueprints

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Name of the Blueprint.

code_mounts
object[] | null

A list of code mounts to be included in the Blueprint.

dockerfile
string | null

Dockerfile contents to be used to build the Blueprint.

file_mounts
object | null

(Optional) Map of paths and file contents to write before setup..

launch_parameters
object

Parameters to configure your Devbox at launch time.

system_setup_commands
string[] | null

A list of commands to run to set up your system.

Response

200 - application/json

Blueprints are ways to create customized starting points for Devboxes. They allow you to define custom starting points for Devboxes such that environment set up can be cached to improve Devbox boot times.

create_time_ms
integer
required

Creation time of the Blueprint (Unix timestamp milliseconds).

id
string
required

The id of the Blueprint.

name
string
required

The name of the Blueprint.

parameters
object
required

The parameters used to create Blueprint.

status
enum<string>
required

The status of the Blueprint build.

Available options:
provisioning,
building,
failed,
build_complete
failure_reason
enum<string>

The failure reason if the Blueprint build failed, if any.

Available options:
out_of_memory,
out_of_disk,
build_failed