Skip to main content
POST
org を特定の成功したビルドに固定する

権限

組織レベルの ManageOrgSnapshots 権限を持つサービスユーザーが必要です。

動作

組織を特定の成功したビルドに固定します。新しいセッションでは、固定を解除するまで、このスナップショットが利用されます。

承認

Authorization
string
header
必須

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

パスパラメータ

build_id
string
必須
org_id
string
必須

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

:

"org-abc123def456"

ボディ

application/json

POST /builds/{id}/pin の本文。仕様上、空です。

レスポンス

成功レスポンス

公開 Build リソースの形式 — 「これはもう成功したか?」だけを示す不透明なビュー。

仕様上、プラットフォーム/スナップショット/ジョブ単位の詳細は公開されません。今後の追加(triggered_by_repo、ビルドメタデータなど)は追加的です。

build_id
string
必須
completed_at
integer | null
必須
created_at
integer
必須
pinned
boolean
必須
started_at
integer | null
必須
status
enum<string>
必須
利用可能なオプション:
pending,
running,
succeeded,
failed,
cancelled
trigger
enum<string> | null
必須
利用可能なオプション:
manual,
auto
triggered_by_user_id
string | null
必須
updated_at
integer
必須