メインコンテンツへスキップ
POST
自動化を作成する

権限

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

実行アイデンティティ

run_as フィールドは必須です。サービスユーザーが作成した自動化では、 organization を使用する必要があります。UsePersonalAutomations 権限を持つ人間のAPI呼び出し元は、creator を使用して、作成者の権限でセッションを実行できます。

トリガーとアクション

自動化では、triggers のいずれかがイベントに一致すると発火し、actions が実行されます (たとえば、プロンプトを指定して Devin セッションを開始します) 。サポートされるトリガーイベントの種類、各イベントの条件フィールドと演算子、イベントの種類ごとに利用可能な応答動詞については、イベントスキーマエンドポイントを参照してください。 トリガーの conditions は、{field, operator, value} 形式の条件を {"any": [{"all": [...]}]} という2層のエンベロープで指定します。null の条件オブジェクトは、すべてのイベントに一致します。

Webhook トリガー

webhook:incoming トリガーを持つ自動化 (最大1つ) には、作成時に受信 URL とシークレットが割り当てられます。更新時に webhook トリガーを再追加すると、シークレットが再発行されて返されます。シークレットは再取得できないため、受け取った時点で保存してください。外部システムは、これを X-Webhook-Secret ヘッダーで送信します。

承認

Authorization
string
header
必須

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

パスパラメータ

org_id
string
必須

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

例:

"org-abc123def456"

ボディ

application/json
name
string
必須
Required string length: 1 - 500
triggers
AutomationTriggerRequest · object[]
必須

いずれかのトリガーが一致すると、イベントごとに 1 回発生します。webhook:incoming トリガーは最大 1 つです。

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
必須

空であってはなりません。上限: start_session は最大 1 つ、monitor_session は唯一のアクションである必要があります。

run_as
AutomationRunAsOrganization · object
必須

必須: 起動されたセッションの実行 ID(組織、作成者、または service_user)を明示的に選択します。

enabled
boolean
デフォルト:true
notifications
AutomationNotifications · object | null
tools
AutomationTools · object | null
metadata
Metadata · object

自動化の整理・フィルタリングに使用する、組織内で表示されるキー/値ラベル。最大 16 組、キーは最大 32 文字、値は最大 128 文字。

limits
AutomationLimits · object | null
concurrency
AutomationConcurrency · object | null
session_settings
AutomationSessionSettings · object | null

この自動化が起動するセッションに適用されます。

security_profile
AutomationSecurityProfileSelection · object | null

自動化自体のセキュリティプロファイル バインド。省略した場合は組織または Enterprise から継承します。セキュリティプロファイルの管理権限が必要です。

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

作成時にのみ使用する来歴マーカー。ID は templates エンドポイントで解決します。設定され、tools.mcp_servers が省略されている場合は、テンプレートの required_mcps が適用されます。

script_check
AutomationScriptCheckRequest · object | null

省略可能なスクリプトによるプリフライトチェック。アクションの実行前に動作し、トリガーごとに続行、スキップ、または複数への分岐を判断します。自動化とともに検証・保存されます。

llm_check
AutomationLlmCheckRequest · object | null

省略可能なLLMチェック。高速なモデルが、トリガーイベントごとに自動化を実行するかどうかを判断します。

レスポンス

成功レスポンス

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。