メインコンテンツへスキップ
POST /v1/sessions/{session_id}/threads/{thread_id}/archive 子スレッドをアーカイブします。アーカイブ操作はスレッドステータスを archived に設定し、保留中の mailbox メッセージをすべてキャンセルし、Coordinator スレッドのブロックを解除します（該当する場合）。
role が child のスレッドのみアーカイブできます。Coordinator スレッドはアーカイブできません。

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer <PAT>

​
パスパラメータ

パラメータ型必須説明
session_idstringはいSession ID（sess_ プレフィックス）
thread_idstringはいThread ID（sthr_ プレフィックス）

​
リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/sessions/sess_019f00000000000000000000000000aa/threads/sthr_019f00000000000000000000000002bb/archive" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "id": "sthr_019f00000000000000000000000002bb",
  "type": "session_thread",
  "session_id": "sess_019f00000000000000000000000000aa",
  "parent_thread_id": "sthr_019f00000000000000000000000001aa",
  "agent": {
    "id": "agent_019f000000000000000000000000002b",
    "type": "agent",
    "name": "Research Agent",
    "model": "ultimate",
    "version": 2
  },
  "agent_id": "agent_019f000000000000000000000000002b",
  "agent_version": 2,
  "name": "Research Agent",
  "role": "child",
  "status": "archived",
  "stop_reason": {"type": "archive"},
  "created_by_tool_use_id": "toolu_bdrk_01T42NPLcKrBvLJfWgGt3QMt",
  "archived_at": "2026-06-15T08:10:00.000Z",
  "created_at": "2026-06-15T08:01:00.000Z",
  "updated_at": "2026-06-15T08:10:00.000Z"
}

​
レスポンスフィールド

アーカイブされた Session Thread オブジェクト を返します。status は "archived" になり、stop_reason は {"type": "archive"} に設定されます。

​
アーカイブの動作

アーカイブ操作は以下をトリガーします:
  • スレッドステータスが archived に設定される
  • スレッドの mailbox 内の保留中メッセージがすべてキャンセルされる
  • Coordinator が Agent ツール経由でこのスレッドの結果を待っている場合、"Agent cancelled." のツール結果を受信し、Coordinator は実行を再開する
  • session.thread_status_terminated イベントが stop_reason を {"type": "archive"} に設定して発行される

​
エラーコード

HTTPtypeトリガー条件
401authentication_errorPAT が無効または期限切れ
404not_found_errorSession または Thread が存在しない
409invalid_request_errorCoordinator スレッドをアーカイブしようとした
409invalid_request_errorスレッドステータスが idle ではなくアーカイブできない
完全なエラーエンベロープリファレンスは エラー を参照してください。

​
関連項目

Managed Agents

マルチ Agent 協調とスレッドライフサイクルの全体像を確認します。

Session Threads 一覧

Session 内のすべてのスレッドとそのステータスを取得します。

スレッドイベント一覧

アーカイブ後のスレッドイベント履歴を確認します。

Session Thread オブジェクト

archived ステータスや stop_reason フィールドの仕様を参照します。