セッションの更新 - AI Coding Assistant Lingma - Alibaba Cloud ドキュメントセンター

title や metadata などのセッション属性を更新します。変更するフィールドのみを含めてください。

パスパラメーター

パラメーター	タイプ	説明
session_id	文字列	sess_ プレフィックスを持つセッション ID

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer $QODER_PAT
Content-Type	はい	application/json

リクエストボディ

フィールド	タイプ	必須	説明
title	文字列	いいえ	新しいセッションタイトル
metadata	オブジェクト	いいえ	新しいメタデータ (完全置換)

リクエスト例

curl -X POST https://api.qoder.com.cn/api/v1/cloud/sessions/sess_019e3bb1e8c171fd9abbb1477ffb84cc \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "New title",
    "metadata": {"priority": "high"}
  }'

レスポンス例

HTTP 200 OK

更新されたセッションオブジェクトが、更新された updated_at タイムスタンプとともに返されます。

{
  "agent": {
    "created_at": "2026-05-27T08:22:05.558081Z",
    "default_environment": "",
    "description": "",
    "id": "agent_019e6886cdf5778098368adde92a2a02",
    "instructions": "You are a general-purpose assistant capable of research, writing code, running commands, and using tools end-to-end to complete tasks.",
    "mcp_servers": [],
    "model": "ultimate",
    "name": "Hello World Agent",
    "system": "You are a general-purpose assistant capable of research, writing code, running commands, and using tools end-to-end to complete tasks.",
    "tools": [
      {
        "enabled_tools": ["WebFetch", "WebSearch", "Bash", "Glob", "Read", "Grep", "Write", "Edit"],
        "type": "agent_toolset_20260401"
      }
    ],
    "type": "agent",
    "updated_at": "2026-05-27T10:09:09.542948Z",
    "version": 3
  },
  "agent_id": "agent_019e6886cdf5778098368adde92a2a02",
  "created_at": "2026-05-27T15:30:48.336828Z",
  "environment_id": "env_019e6954e74770d6bce983cdb53be448",
  "id": "sess_019e6a0f4d9170a989eee39f6685f3fb",
  "memory_store_ids": [],
  "resources": [
    {
      "file_id": "file_019e6a18dc0978e9a2104c9b269748ac",
      "path": "/data/data/data/file_019e6a18dc0978e9a2104c9b269748ac",
      "type": "file"
    }
  ],
  "status": "idle",
  "title": "doc-test-title",
  "turn_status": "idle",
  "type": "session",
  "updated_at": "2026-05-28T02:09:42.156418Z",
  "vault_ids": []
}

注意事項

説明ネストされた agent オブジェクトには、archived / archived_at フィールドが含まれません (GET /agents API のトップレベルレスポンスとは異なります)。

エラー

HTTP	タイプ	トリガー
400	invalid_request_error	不正な形式のリクエストボディ
401	authentication_error	PAT が無効または期限切れ
404	not_found_error	セッションが存在しません

完全なエラーエンベロープについては、エラーをご参照ください。