Sign in

v49

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01151216390.1 KB
Blueprint
Blueprint-Lifecycle

Get a Blueprint.

Get the details of a previously created Blueprint including the build status.

get/v1/blueprints/{id}

Path parameters

idstring required

The ID of the Blueprint

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.