メインコンテンツへスキップ
POST
セッションを作成

権限

組織レベルで UseDevinSessions (org.devins.use) 権限が付与されたサービスユーザーまたはパーソナルアクセストークンが必要です。

高度な機能用の追加権限

Devin モード

devin_mode パラメータは、このセッションで使用する Devin のエージェントモードを制御します。 省略した場合、セッションでは組織のデフォルトモードが使用されます。プレビューモードには、Web アプリと同じ機能フラグおよび Enterprise のエージェントプレビューに関する制限が適用されます。

ユーザーのなりすまし

create_as_user_id パラメータを使用すると、別のユーザーに代わってセッションを作成できます。これには以下が必要です:
  1. サービスユーザーが ImpersonateOrgSessions 権限を持っていること
  2. 対象ユーザーが組織のメンバーであること
  3. 対象ユーザーが UseDevinSessions 権限を持っていること

承認

Authorization
string
header
必須

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

パスパラメータ

org_id
string | null
必須

組織 ID(prefix: org-)

例:

"org-abc123def456"

クエリパラメータ

devin_id
string | null

ボディ

application/json
prompt
string
必須
title
string | null
tags
string[] | null
max_acu_limit
integer | null
playbook_id
string | null
knowledge_ids
string[] | null
secret_ids
string[] | null
session_secrets
SessionSecretInput · object[] | null
repos
string[] | null
attachment_urls
string<uri>[] | null
Required string length: 1 - 2083
create_as_user_id
string | null
child_playbook_id
string | null
bypass_approval
boolean | null
security_profile
SessionSecurityProfileSelection · object | null

このセッションにセキュリティプロファイルを割り当てます。省略すると、デフォルトの選択ルールが適用されます(プレイブックにセキュリティプロファイルが紐付けられている場合はそれを優先し、次に組織/Enterprise のデフォルトを適用)。セキュリティプロファイル管理権限が必要です。

structured_output_schema
Structured Output Schema · object | null

構造化出力を検証するためのJSON Schema(Draft 7)。最大64KB。自己完結型である必要があります(外部の$refは不可)。

structured_output_required
boolean | null

true(デフォルト)の場合、エージェントは自身のターンが終了する前に、is_final=trueを指定してprovide_structured_outputを必ず呼び出す必要があります。falseの場合、このツールは利用可能ですが必須ではなく、特定のターンで呼び出されることは保証されません。

resumable
boolean
デフォルト:true

停止後も再開できるよう、セッションのVM状態を保持するかどうか。使い捨てセッションの場合は false に設定します。

memory_enabled
boolean | null

このセッションとその子セッションでMemoriesを無効にするには、falseに設定します。Memoriesの読み取りや書き込みは行われず、Memoriesがトランスクリプトから学習することもありません。所有者のMemories設定に従うには、このフィールドを省略するかtrueに設定します。trueにしても、所有者の設定でオフになっているMemoriesがオンになることはありません。

platform
string | null

セッションの VM プラットフォーム(例: 'windows')を上書きするか、セッションをお客様自身のマシンのいずれかで実行するためのアウトポスト(BYOB)プール名を指定します。省略した場合(または 'inherit' に設定した場合)、親 Devin によって作成されたセッションは、親の配置(プラットフォームとアウトポストプールの両方)を継承します。そのため、アウトポストに配置された親は同じプール上に子を起動します。それ以外の場合は、組織のデフォルトが利用されます。指定する値は、組織向けに設定されたプラットフォーム、またはアウトポストプール名のいずれかと一致している必要があります(大文字と小文字は区別されません)。名前が両方に一致する場合は、組み込みプラットフォームが優先されます。また、呼び出し元が所有する個人用のアウトポストプールは、同じ名前のアカウント全体で共有されるプールよりも優先されます。認識されない値は 400 エラーで拒否され、エラーボディにはその組織で利用可能なプラットフォームラベルとアウトポストプール名の一覧が含まれます。

devin_mode
enum<string> | null

このセッションのDevinエージェントモードを上書きします。'normal' ではデフォルトのエージェントモード、'fast' ではFast mode、'lite' ではDevin Lite、'ultra' ではDevin Ultra、'fusion' ではFusionを使用します。その他の値では、Webアプリ内の同名のエージェントモードを選択します。プレビューモードには、Webアプリと同じfeature flagおよびEnterprise agent previewの制限が適用されます。

利用可能なオプション:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max

レスポンス

成功レスポンス

session_id
string
必須
url
string
必須
status
enum<string>
必須
利用可能なオプション:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
必須
org_id
string | null
必須

所有元の組織。分離セッションは組織ではなく作成者のアカウントが所有するため、Null になります。

created_at
integer
必須
updated_at
integer
必須
acus_consumed
number
必須
pull_requests
SessionPullRequest · object[]
必須
title
string | null
playbook_id
string | null
user_id
string | null
is_archived
boolean
デフォルト:false
parent_session_id
string | null
child_session_ids
string[] | null
service_user_id
string | null
category
enum<string> | null

分類が実行されている場合の、セッションに割り当てられたユースケースカテゴリ。GET/list エンドポイントでのみ設定されます。

利用可能なオプション:
bug_fixing,
ci_cd_and_devops,
code_quality_and_security,
code_review,
code_review_and_analysis,
data_and_automation,
documentation_and_content,
feature_development,
migrations_and_upgrades,
other,
production_investigation,
refactoring_and_optimization,
research_and_exploration,
security,
unit_test_generation
subcategory
string | null

セッションに割り当てられたサブカテゴリの表示名。カテゴリが設定されていてもサブカテゴリが割り当てられなかった、または解決されなかった場合は「Other」です。GET/list エンドポイントでのみ設定されます。

origin
enum<string> | null

セッションの作成元。

利用可能なオプション:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
automation_id
string | null

このセッションを作成した自動化のID(該当する場合)。

structured_output
Structured Output · object | null

セッションからの検証済み構造化出力。GET/list エンドポイントでのみ設定されます。

devin_mode
enum<string> | null

組織/ユーザーのデフォルト設定および親セッションからの継承を解決した後に、セッションの作成時に使用されたDevinエージェントモード。モードに相当するものがないエージェントプレビューをセッションが実行する場合はNone。

利用可能なオプション:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max
status_detail
enum<string> | null

セッションの現在の status に関する追加情報。status が 'running' の場合: 'working'(作業中)、'waiting_for_user'(ユーザー入力待ち)、'waiting_for_approval'(セーフモードでのアクション承認待ち)、または 'finished'(タスク完了)。status が 'suspended' の場合: 'inactivity'、'user_request'、'usage_limit_exceeded'、'out_of_credits'、'out_of_quota'、'no_quota_allocation'、'payment_declined'、'org_usage_limit_exceeded'、'user_usage_limit_exceeded'、'total_session_limit_exceeded'、'contract_expired'、または 'error' などの中断理由。GET/list エンドポイントでのみ設定されます。

利用可能なオプション:
working,
waiting_for_user,
waiting_for_approval,
finished,
inactivity,
user_request,
usage_limit_exceeded,
out_of_credits,
out_of_quota,
no_quota_allocation,
payment_declined,
org_usage_limit_exceeded,
user_usage_limit_exceeded,
total_session_limit_exceeded,
contract_expired,
error
on_demand_usage
number | null

このセッションのオンデマンド(超過利用)料金(米ドル)。子セッションは含みません。Teamsプランの場合にのみ値が設定され、セッションの使用量がすべて利用枠内であれば 0 になります。それ以外のプランでは省略されます。GET/一覧取得エンドポイントでのみ値が設定されます。

security_profile
SessionSecurityProfileResponse · object | null

セッション自体のセキュリティプロファイルのバインド。GET/list エンドポイントでのみ設定されます。