Skip to main content
PATCH
自動化を更新

権限

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

マージのセマンティクス

デフォルトの merge_patch セマンティクスでは、PATCH フィールドはメンバーごとにマージされます (RFC 7396 形式) 。省略したメンバーは保存済みの値が維持され、明示的な null はクリアされ、空のグループは no-op です。メタデータはキーごとにマージされ、null 値はキーを削除します。リストは全体が置き換えられますが、各送信要素は、その型が送信側と保存済み側の両方でちょうど 1 回ずつ出現する場合、同じ型の保存済み要素にマージされます。 replace_groups セマンティクスでは、マージは行われません。送信されたオブジェクトグループは保存済みのグループ全体を置き換え、送信された triggers または actions リストは、要素ごとのマージを行わずに保存済みリスト全体を置き換えます。保持したいメンバーはすべて再送信してください。省略したメンバーはクリアされるか、デフォルト値にリセットされます。metadata も完全な置換セットとなるため、キーを削除するには、そのキーを含めないセットを再送信します。null のメタデータ値はキーを削除するのではなく、400 エラーで拒否されます。省略したトップレベルフィールドは引き続き変更されません。 いずれの動作に依存する前にも、イベントスキーマエンドポイントupdate_semantics フィールドで、組織でアクティブなセマンティクスを確認してください。これをオープンな列挙型として扱い、上記の 2 つ以外の値も許容してください。

Webhook トリガー

webhook:incoming トリガーを再追加すると、新しいシークレットが生成され、更新レスポンスで返されます。シークレットが表示されるのはこのときだけなので、受け取ったら控えておいてください。既存の webhook トリガーを置き換える場合やそのまま保持する場合は、既存のシークレットが維持されます。

承認

Authorization
string
header
必須

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

パスパラメータ

automation_id
string
必須
org_id
string
必須

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

:

"org-abc123def456"

ボディ

application/json

PATCH フィールドはデフォルトでメンバー単位にマージされます。省略されたメンバーは保持され、 明示的な null はクリアされ、空のグループは何も行いません。メタデータはキーごとにマージされ、 null 値はキーを削除します。リストは完全に置換されます(削除するには、要素を除いたリストを再送信します)。 ただし、送信された各要素は、そのタイプが送信側と保存側の両方で正確に 1 回ずつ出現する場合、 同じタイプの保存済み要素にマージされます。作成時に必須の要素メンバー(promptsetup_prompt、monitor/triage Slack 設定、scan_id)は、対応する保存済み要素が存在する場合は 省略できます。他のメンバーと同様に引き継がれます。明示的な null は拒否されます。

actions
(AutomationStartSessionActionUpdate · object | AutomationMessageSessionActionUpdate · object | AutomationMonitorSessionActionUpdate · object)[] | null
concurrency
AutomationConcurrency · object | null
enabled
boolean | null
limits
AutomationLimits · object | null
metadata
Metadata · object | null
name
string | null
Required string length: 1 - 500
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

生成されたセッションの実行に使用する ID。organization: 組織の自動化 ID(アプリ内の System User)。セッションはシステム権限を使用するため、個人(ユーザースコープ)の接続でインストールされた MCP サーバーは選択できず、自動化を organization に切り替えると選択から削除されます。creator: 個人用自動化。作成者自身の権限で実行され、作成者と org 管理者のみが閲覧できます。サービスユーザーが作成した自動化では拒否されます。作成時に必須です。更新時に null を指定すると organization にリセットされます。

security_profile
AutomationSecurityProfileSelection · object | null

自動化自体のセキュリティプロファイルのバインド。profile_id はそのプロファイルを固定し、{"profile_id": null} は明示的なオプトアウトを記録し、明示的な null は組織/Enterprise からの継承に戻します。セキュリティプロファイル管理権限が必要です。

session_settings
AutomationSessionSettings · object | null

この自動化が生成するすべてのセッション(監視セッションを含む)に適用されます。

tools
AutomationTools · object | null
triggers
AutomationTriggerRequest · object[] | null

レスポンス

成功レスポンス

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
必須
automation_id
string
必須
created_at
integer
必須
created_by
ActorResponse · object
必須

アクションまたはリソースに紐付けられたユーザーまたはサービスユーザーのプリンシパル。

enabled
boolean
必須
name
string
必須
triggers
AutomationTriggerResponse · object[]
必須
updated_at
integer
必須
concurrency
AutomationConcurrency · object | null
last_edited_by
ActorResponse · object | null

アクションまたはリソースに紐付けられたユーザーまたはサービスユーザーのプリンシパル。

last_invocation
AutomationLastInvocation · object | null
limits
AutomationLimits · object | null
metadata
Metadata · object
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

生成されるセッションの実行 ID。organization: org の自動化 ID(アプリ内の System User)— セッションはシステム権限を使用するため、個人用(ユーザースコープ)の接続でインストールされた MCPサーバーは選択できません。また、自動化を organization に切り替えると、それらは選択対象から除外されます。creator: 個人用自動化 — 作成者自身の権限で実行され、作成者と org 管理者にのみ表示されます。サービスユーザーが作成した自動化では使用できません。作成時に必須です。更新時に null を指定すると organization にリセットされます。

security_profile
AutomationSecurityProfileResponse · object | null

自動化のセキュリティプロファイルのバインドと、解決された適用プロファイル。組織でセキュリティプロファイルが有効化されていない場合は null。

session_settings
AutomationSessionSettings · object | null

この自動化が生成するすべてのセッション(監視セッションを含む)に適用されます。

template_id
string | null
tools
AutomationTools · object | null