Sign in

v1

latestOpenAPI 3.1.02026-07-26269227514.8 KB
snapshot_setup

Update a blueprint's contents and/or position

Partial update for a single blueprint. Does NOT auto-trigger a build.

Fields honored:

  • contents — writes a new YAML version for the blueprint.
  • position — sets the repo-tier blueprint's execution position. Returns 400 on an org-tier blueprint (those have no position).

Returns 400 when the body is empty.

patch/v3beta1/organizations/{org_id}/snapshot-setup/blueprints/{blueprint_id}

Path parameters

blueprint_idstring required
org_idstring required
Example:org-abc123def456

Organization ID (prefix: org-)

Request body

contentsstring nullable

If set, replaces the blueprint's YAML body with a new version.

positioninteger nullable

If set, updates the execution position of this repo-tier blueprint. Positions are not required to be unique; ties are broken arbitrarily by the server when sorting for execution.

Response

Successful Response

blueprint_idstring required
created_atinteger required
repo_namestring nullable required
type'enterprise' | 'org' | 'repo' required
updated_atinteger required