メインコンテンツへスキップ
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
必須

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

パスパラメータ

automation_id
string
必須
org_id
string
必須

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

例:

"org-abc123def456"

ボディ

application/json

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

name
string | null
Required string length: 1 - 500
triggers
AutomationTriggerRequest · object[] | null
actions
(AutomationStartSessionActionUpdate · object | AutomationMessageSessionActionUpdate · object | AutomationMonitorSessionActionUpdate · object)[] | null
enabled
boolean | null
notifications
AutomationNotifications · object | null
tools
AutomationTools · object | null
metadata
Metadata · object | null
limits
AutomationLimits · object | null
concurrency
AutomationConcurrency · object | null
session_settings
AutomationSessionSettings · object | null

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

security_profile
AutomationSecurityProfileSelection · object | null

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

run_as
AutomationRunAsOrganization · object

生成されたセッションの run に使用する ID。organization: 組織の自動化 ID。組織に自動化用のデフォルトのサービスユーザーが設定されている場合、セッションはそのサービスユーザーとして run され、レスポンスには run_as の値として service_user が、そのサービスユーザーの id とともに返されます。保存するには、そのサービスユーザーが持つすべての権限が必要です。設定されていない場合、自動化の作成や有効な自動化の保存は拒否されます。個人用(user-scoped)の接続でインストールされた MCPサーバーのうち、そのサービスユーザーが接続していないものは選択できません。自動化を organization に切り替えると、それらは選択肢から除外されます。creator: 個人用自動化 — 作成者自身の権限で run され、作成者と org 管理者にのみ表示されます。サービスユーザーが作成した自動化では拒否されます。service_user: 指定されたサービスユーザーとして、そのユーザーのロール、付与された権限、ACU上限に従って run されます。そのサービスユーザーを管理する権限が必要です。作成時に必須です。更新時に null を指定すると organization にリセットされます。

slack_reply_access
enum<string> | null

null を指定すると slack_users にリセットされます。

利用可能なオプション:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string> | null

null を指定すると teams_users にリセットされます。

利用可能なオプション:
devin_users,
teams_users
script_check
Script Check · object

自動化のスクリプトによるプリフライトチェック(スクリプト、ランタイム、タイムアウト、シークレット、有効状態)を置き換えます。省略すると現在の設定が保持されます。null は指定できません。無効にするには、代わりに enabled=false を指定してください。

llm_check
Llm Check · object

自動化の LLM チェック(フィルター用 prompt と有効状態)を置き換えます。省略すると現在の設定が保持されます。null は指定できません。無効にするには、代わりに enabled=false を指定してください。

レスポンス

成功レスポンス

automation_id
string
必須
name
string
必須
enabled
boolean
必須
triggers
AutomationTriggerResponse · object[]
必須
actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
必須
created_by
ActorResponse · object
必須

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

created_at
integer
必須
updated_at
integer
必須
notifications
AutomationNotifications · object | null
tools
AutomationTools · object | null
metadata
Metadata · object
limits
AutomationLimits · object | null
concurrency
AutomationConcurrency · object | null
session_settings
AutomationSessionSettings · object | null

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

security_profile
AutomationSecurityProfileResponse · object | null

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

run_as
AutomationRunAsOrganization · object

生成されたセッションの run に使用する ID。organization: 組織の自動化 ID。組織に自動化用のデフォルトのサービスユーザーが設定されている場合、セッションはそのサービスユーザーとして run され、レスポンスの run_as は service_user となり、その id も返されます。保存には、そのサービスユーザーが持つすべての権限が必要です。デフォルトのサービスユーザーが設定されていない場合、自動化の作成や有効な自動化の保存は拒否されます。そのサービスユーザーが未接続の個人用(user-scoped)接続でインストールされた MCPサーバーは選択できません。また、自動化を organization に切り替えると、それらは選択肢から削除されます。creator: 個人用自動化 — 作成者自身の権限で run され、作成者と org 管理者にのみ表示されます。サービスユーザーが作成した自動化では使用できません。service_user: 指定したサービスユーザーとして、そのロール、付与された権限、ACU上限に従って run されます。そのサービスユーザーを管理する権限が必要です。作成時は必須です。更新時に null を指定すると organization にリセットされます。

slack_reply_access
enum<string>
デフォルト:slack_users

Slack スレッドから既存のセッションに返信できるユーザー:devin_users(リンクされた Devin アカウントのみ)、slack_users(組織に接続された Slack ワークスペース内の全ユーザー)、または external_slack_users(Slack Connect ユーザーも含む)。自動化をトリガーできるユーザーには影響しません。

利用可能なオプション:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string>
デフォルト:teams_users

Microsoft Teams スレッドから既存のセッションに返信できるユーザー:devin_users(リンクされた Devin アカウントのみ)、または teams_users(組織に接続された Microsoft テナント内の全ユーザー。既定値)。自動化をトリガーできるユーザーには影響しません。

利用可能なオプション:
devin_users,
teams_users
template_id
string | null
last_edited_by
ActorResponse · object | null

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

last_invocation
AutomationLastInvocation · object | null
next_run_at
integer | null

自動化の Schedule トリガーが次に発動する日時。Schedule トリガーがない場合、自動化が無効な場合、またはすべてのスケジュールが終了日を過ぎている場合は null。