Skip to navigation
API ReferenceV3

Create an org- or repo-tier blueprint

Create a blueprint. type is inferred from repo_name.

Per spec, this never auto-triggers a build — callers must POST /builds explicitly.

Authentication

AuthorizationBearer

Personal API Key (apk_user_) or Service API Key (apk_)

Path parameters

org_idstringRequired

Request

This endpoint expects an object.
contentsstring or nullOptional
Optional initial YAML body for the blueprint.
repo_namestring or nullOptional

If set, creates a repo-tier blueprint for that repository. If omitted, creates an org-wide (org-tier) blueprint.

Response

Successful Response
blueprint_idstring
created_atinteger
repo_namestring or null
typeenum
Allowed values:
updated_atinteger

Errors

422
Unprocessable Entity Error