メインコンテンツへスキップ
POST
セッションをアーカイブ
devin_id は、セッション ID の先頭に devin- が付いた値です (例: devin-abc123) 。

権限

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

注意事項

セッションをアーカイブすると、そのセッションと子孫セッションがアーカイブ済み (is_archived: true) としてマークされ、実行中のセッションはスリープ状態になります。アーカイブ済みのセッションを探すには、セッション一覧エンドポイントで is_archived によるフィルタリングを行ってください。 アーカイブしても、セッションが削除されたり、追加のデータが保持されたり、読み取り専用になったりすることはありません。
  • アーカイブ済みのセッションも引き続き閲覧でき、タグの編集も可能です。
  • スリープ中のアーカイブ済みセッションにメッセージを送信すると、セッションが再開されます。終了したセッションは、アーカイブの有無にかかわらず再開できません。
  • アーカイブを取り消すには、POST /v3/organizations/{org_id}/sessions/{devin_id}/unarchive を呼び出してください。アーカイブ解除はリクエストしたセッションにのみ適用され、子孫セッションには適用されません。

承認

Authorization
string
header
必須

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

パスパラメータ

org_id
string | null
必須

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

例:

"org-abc123def456"

devin_id
string | null
必須

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

例:

"devin-abc123def456"

レスポンス

成功レスポンス

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 エンドポイントでのみ設定されます。