メインコンテンツへスキップ
PATCH
ブループリントの内容、位置、ソース、コミット時のbuild設定のいずれかまたはすべてを更新する

権限

組織レベルで ManageRepoBlueprints 権限を持つサービスユーザーまたはパーソナルアクセストークンが必要です。組織ティアのブループリントを作成または更新するには、ManageOrgSnapshots 権限が必要です。

動作

ブループリントの内容や位置を更新します。ビルドは自動ではトリガーされません。

承認

Authorization
string
header
必須

サービスユーザーの credential(プレフィックス: cog_)

パスパラメータ

blueprint_id
string
必須
org_id
string
必須

組織ID(プレフィックス:org-)

例:

"org-abc123def456"

ボディ

application/json

組織ティアまたは repo ティアのブループリントに対する部分更新。

フィールドは任意の一部のみを与えることができます。設定されていないフィールドはそのまま維持されます。 組織ティアのブループリントに position、source、またはコミット時の build 設定を与えると 400 が返されます — これらを持つのは repo ティアのブループリントのみです。 build はトリガーされません。

contents
string | null

設定されている場合、ブループリントの YAML 本文を新しいバージョンに置き換えます。

position
integer | null

設定されている場合、この repo ティアのブループリントの実行位置を更新します。位置は一意である必要はなく、実行順に並べ替える際に同順位がある場合はサーバーが任意に決定します。

source
enum<string> | null

設定すると、リポジトリのブループリントのソースが切り替わります。リポジトリのルートブループリントでのみ指定できます(スコープ付きブループリントはこの設定を継承します)。'git' はデフォルトブランチから .devin/blueprint.yaml を取得し(存在しない場合は 404)、'contents' とは併用できません。'database' は現在の YAML('contents' が指定されている場合はその内容)を保持し、リポジトリからの同期を停止します。ブループリントがすでにそのモードになっている場合は no-op です。

利用可能なオプション:
git,
database
build_on_default_branch_commit
boolean | null

設定すると、デフォルトブランチへのプッシュのたびに環境をbuildするかどうかを切り替えられます。github.com リポジトリのルートブループリントでのみ指定できます。該当するプッシュのたびにbuildがキューに追加されます。

report_check_runs
boolean | null

設定すると、各コミットのbuildを GitHub チェック run として報告するかどうかを切り替えられます。有効にするには、'build_on_default_branch_commit' がオンになっている必要があります。

レスポンス

成功レスポンス

公開 Blueprint リソースのスキーマ。

注: type 列挙型には今後新しい値が追加される可能性があります。クライアントは未知の値も適切に処理する必要があります。YAML の内容は GET /blueprints/{id}/contents から別途取得します。

blueprint_id
string
必須
type
enum<string>
必須
利用可能なオプション:
enterprise,
org,
repo
repo_name
string | null
必須
created_at
integer
必須
updated_at
integer
必須
source
enum<string> | null

YAML の作成場所:'git'(リポジトリ内の .devin/blueprint.yaml から同期)または 'database'(API/UI で編集)。Enterprise ティアおよび組織ティアのブループリントでは常に null です。

利用可能なオプション:
git,
database
build_on_default_branch_commit
boolean | null

リポジトリのデフォルトブランチへのプッシュごとに環境を build するかどうか。リポジトリのルートブループリントでない場合は null。

report_check_runs
boolean | null

各コミットの build を、そのコミットの GitHub チェック run として報告するかどうか。リポジトリのルートブループリントでない場合は null。