メインコンテンツへスキップ
PUT
組織レベルのプレイブックを更新
プレイブックはスキルへの移行が進められています。移行済みのアカウントでは、このリクエストはプレイブックの代わりに対応するスキルへ書き込みます。作成リクエストではスキルが追加され、更新ではスキルが変更され、削除ではスキルが削除されます。スキルの作成と編集は Customize ページで行ってください。2026年10月24日以降、新規アカウントは最初からスキルを使用し、プレイブックは提供されません。詳しくはプレイブックはスキルに移行しますを参照してください。

権限

組織レベルで ManageOrgPlaybooks (org.playbooks.manage) 権限を持つサービスユーザーまたはパーソナルアクセストークンが必要です。

承認

Authorization
string
header
必須

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

パスパラメータ

playbook_id
string
必須

プレイブック ID(接頭辞: playbook-)

例:

"playbook-abc123def456"

org_id
string
必須

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

例:

"org-abc123def456"

ボディ

application/json
title
string
必須
body
string
必須
macro
string | null

Playbook マクロ識別子。先頭は '!' で始まり、その後に1文字以上の英字、数字、アンダースコア、またはハイフンが続く必要があります。例: '!my_macro' または '!my-macro'

structured_output_schema
Structured Output Schema · object | null

このplaybookを使用するセッションが構造化出力として生成する JSON Schema(Draft 7)。最大64KB。自己完結している必要があります(外部 $ref は使用不可)。

レスポンス

成功レスポンス

playbook_id
string
必須
title
string
必須
body
string
必須
macro
string | null
必須
created_by
string
必須
updated_by
string
必須
created_at
integer
必須
updated_at
integer
必須
access_type
enum<string>
必須
利用可能なオプション:
enterprise,
org
org_id
string | null
必須
structured_output_schema
Structured Output Schema · object | null