メインコンテンツへスキップ
POST /v1/sessions/{session_id}/archive Session をアーカイブします。アーカイブされた Session はデフォルトの一覧には表示されなくなりますが、include_archived=true を指定すると一覧に含まれます。

​
パスパラメータ

パラメータ型説明
session_idstringSession ID（sess_ プレフィックス）

​
ヘッダー

名称必須値
AuthorizationはいBearer $QODER_PAT

​
リクエスト例

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

​
レスポンス例

HTTP 200 OK 完全な Session オブジェクトを返します。 
{
  "id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
  "type": "session",
  "agent_id": "agent_019e390add9f7bac9b6cc806db46fcbd",
  "agent": { "..." },
  "environment_id": "env_019e2590d33f711fabf42f2857cecd8a",
  "title": "API-doc-verification-session-updated",
  "status": "idle",
  "turn_status": "idle",
  "metadata": {},
  "resources": [],
  "vault_ids": [],
  "memory_store_ids": [],
  "environment_variables": {},
  "stats": {"active_seconds": 0, "duration_seconds": 0},
  "archived_at": "2026-05-18T15:26:35.5596Z",
  "created_at": "2026-05-18T15:26:15.747298Z",
  "updated_at": "2026-05-18T15:26:35.5596Z"
}

​
レスポンスフィールド

レスポンスは Session の取得 と同じ Session オブジェクト構造です。アーカイブ時に archived_at が設定されますが、status フィールド自体は "archived" にはなりません。

​
エラーレスポンス

HTTPtype説明
401authentication_errorPAT が無効または期限切れ
404not_found_errorSession が存在しない
アーカイブ後も Session の status は "idle" のまま変わりません。アーカイブ解除のエンドポイントはありません。

​
関連項目

Session の起動

Agent を環境で実行し、ステートフルな対話を行う。