Skip to main content
POST
組織レベルまたはリポジトリレベルのブループリントを作成する

権限

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

動作

org または repo ティアのブループリントを作成します。ブループリントは、Devin セッション用の宣言的な環境設定を定義します。ブループリントを変更してもビルドは自動ではトリガーされません。builds エンドポイントを明示的に呼び出す必要があります。
ブループリントは環境設定とは独立して存在しません。repo_name を指定してブループリントを作成すると、そのリポジトリも環境に追加されます。事前にリポジトリを登録するための別個のエンドポイントはありません。リポジトリは次回のビルド時に環境へクローンされ、インデックス作成が開始されます。逆も同様です。環境からリポジトリを削除すると (UI の Include in environment トグル) 、そのリポジトリのすべてのブループリント (すべてのワークスペーススコープを含む) が削除されます。
リポジトリ名は、Git 統合を通じて Devin がすでにアクセスできるものである必要があります (例: owner/repo) 。不明なリポジトリまたはアクセスできないリポジトリの場合は 404 が返され、ブループリントは作成されません。そのリポジトリとスコープにアクティブなブループリントがすでに存在する場合、リクエストは 409 を返します。代わりに update エンドポイントを使用してください。

承認

Authorization
string
header
必須

サービスユーザーの認証情報(接頭辞: cog_)

パスパラメータ

org_id
string
必須

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

例:

"org-abc123def456"

ボディ

application/json
contents
string | null

ブループリントの初期 YAML 本文(省略可)。source='git' の場合は指定できません(内容はリポジトリから取得されます)。

repo_name
string | null

設定すると、そのリポジトリ用の repo ティア ブループリントを作成します。省略した場合は、org-wide(org-tier)ブループリントを作成します。

source
enum<string> | null

リポジトリ階層のみ。'git' はリポジトリのデフォルトブランチから .devin/blueprint.yaml(およびそのインクルードファイル)を読み込み、ブループリントをその内容と同期します。'database' は YAML を Devin に保存します。省略時のデフォルトは 'database' です。

利用可能なオプション:
git,
database

レスポンス

成功レスポンス

公開 Blueprint リソースの形式。

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

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

リポジトリのデフォルトブランチにプッシュされるたびに環境を build するかどうか。リポジトリのルートブループリントでない場合は Null。

report_check_runs
boolean | null

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

source
enum<string> | null

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

利用可能なオプション:
git,
database