メインコンテンツへスキップ
GET
セッションを取得 (GET)
devin_id は、devin- を先頭に付けたセッション ID です (例: devin-abc123) 。

権限

組織に属し、対象のセッションを閲覧できるサービスユーザーまたはパーソナルアクセストークンが必要です。呼び出し元は、次のいずれかに該当する場合にセッションを閲覧できます。
  • 自身がそのセッションを作成した。
  • そのセッションに対する session.view の権限付与を保持している。
  • 組織レベルで ViewOrgSessions 権限を持っている。
ViewOrgSessions は、サービスユーザー自身が作成しておらず、session.view の権限付与も保持していないセッションを読み取る場合にのみ必要です。

オンデマンド使用量

Teamsプランでは、レスポンスに on_demand_usage が含まれます。これは、そのセッションのオンデマンド (超過利用) 料金をUSDで表したもので、子セッション分は含まれません。セッションの使用量がすべてプランの利用枠内に収まった場合、値は 0 になります。その他のプラン、およびエンタープライズ向けのセッションエンドポイントでは、このフィールドは返されません。

承認

Authorization
string
header
必須

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

パスパラメータ

org_id
string | null
必須

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

例:

"org-abc123def456"

devin_id
string | null
必須

DevinセッションID(プレフィックス: devin-)

例:

"devin-abc123def456"

レスポンス

成功レスポンス

acus_consumed
number
必須
created_at
integer
必須
org_id
string | null
必須

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

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

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

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
child_session_ids
string[] | null
devin_mode
enum<string> | null

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

利用可能なオプション:
normal,
fast,
fusion,
lite,
ultra,
swe-2-medium,
swe-2-high,
swe-2-max
is_archived
boolean
デフォルト:false
on_demand_usage
number | null

子セッションを除く、このセッションのオンデマンド(超過利用)の費用(USD)。Teamsプランでのみ値が設定され、セッション全体が利用枠内に収まった場合は0になります。その他のプランでは省略されます。GET/一覧取得エンドポイントでのみ値が設定されます。

origin
enum<string> | null

セッションの作成元です。

利用可能なオプション:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
parent_session_id
string | null
playbook_id
string | null
security_profile
SessionSecurityProfileResponse · object | null

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

service_user_id
string | null
status_detail
enum<string> | null

セッションの現在のステータスに関する追加情報です。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
structured_output
Structured Output · object | null

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

subcategory
string | null

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

title
string | null
user_id
string | null