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.

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