Blueprint
Blueprint-Lifecycle

Create and build a Blueprint from a RepositoryConnection Inspection.

Starts build of custom defined container Blueprint using a RepositoryConnection Inspection as a source container specification.

post/v1/blueprints/create_from_inspection

Request body

namestring required

Name of the Blueprint.

system_setup_commandsstring[] nullable

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

file_mountsobject nullable

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

metadataobject nullable

(Optional) User defined metadata for the Blueprint.

secretsobject nullable

(Optional) Map of mount IDs/environment variable names to secret names. Secrets can be used as environment variables in system_setup_commands. Example: {"GITHUB_TOKEN": "gh_secret"} makes 'gh_secret' available as GITHUB_TOKEN.

network_policy_idstring nullable

(Optional) ID of the network policy to apply during blueprint build. This restricts network access during the build process.

Response

OK

idstring required

The id of the Blueprint.

namestring required

The name of the Blueprint.

status'queued' | 'provisioning' | 'building' | 'failed' | 'build_complete' required

The status of the Blueprint build.

queued: Blueprint is queued waiting for build capacity to become available. provisioning: Allocating and booting the necessary infrastructure resources to create the Blueprint image. building: Building the Blueprint image. failed: Blueprint image failed to build. See the logs on the dashboard. build_complete: Blueprint image completed build. You can now use the ID to create Devboxes.

state'created' | 'deleted' required
create_time_msinteger required

Creation time of the Blueprint (Unix timestamp milliseconds).

build_finish_time_msinteger nullable

Build completion time of the Blueprint (Unix timestamp milliseconds).

failure_reason'out_of_memory' | 'out_of_disk' | 'build_failed'

The cause of the failure of the Blueprint build.

out_of_memory: The build has run out of memory. Contact support if this is unexpected. out_of_disk: The build has run out of disk. Contact support if this is unexpected. build_failed: The build has failed. Use the dashboard to look at Blueprint build logs for more info.

base_blueprint_idstring nullable

The ID of the base Blueprint.

is_publicboolean

Whether this Blueprint is publicly accessible to all users.

metadataobject nullable

User defined metadata associated with the blueprint.

devbox_capabilitiesDevboxCapabilities[] nullable

Capabilities that will be available on Devbox.

Changes