Skip to main content
GET
Get the enterprise blueprint

Permissions

Requires a service user or personal access token with the ManageAccountSnapshots permission at the enterprise level.

Behavior

Returns the metadata of the enterprise blueprint. The response does not include the YAML. Use Get Enterprise Blueprint Contents to download the YAML.

Errors

  • 404 Not Found: The blueprint does not exist, is deleted, or is not the enterprise blueprint of this account.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

blueprint_id
string
required

Response

Successful Response

Public Blueprint resource shape.

Note: the type enum may grow in the future; clients MUST gracefully handle unknown values. YAML contents are fetched separately via GET /blueprints/{id}/contents.

blueprint_id
string
required
created_at
integer
required
repo_name
string | null
required
type
enum<string>
required
Available options:
enterprise,
org,
repo
updated_at
integer
required
build_on_default_branch_commit
boolean | null

Whether each push to the repo's default branch builds the environment. Null unless this is a repo's root blueprint.

report_check_runs
boolean | null

Whether each commit build is reported as a GitHub check run on the commit. Null unless this is a repo's root blueprint.

source
enum<string> | null

Where the YAML is authored: 'git' (synced from .devin/blueprint.yaml in the repo) or 'database' (edited via the API/UI). Always null for enterprise- and org-tier blueprints.

Available options:
git,
database