Qoder CN シリーズ:セッションの更新

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>
Content-Type	はい	application/json
Idempotency-Key	いいえ	安全でないリクエストに対する任意のべき等キー。

パスパラメーター

パラメーター	タイプ	必須	説明
session_id	文字列	はい	セッション ID。

リクエストボディ

パラメーター	タイプ	必須	説明
title	文字列	いいえ	新しいセッションのタイトル。
metadata	object	いいえ	メタデータオブジェクト。指定したキーは既存のメタデータを上書きし、リクエストに含まれないキーは変更されません。

リクエストの例

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated session title",
    "metadata": {
      "source": "mobile",
      "biz_id": "ticket_123"
    }
  }'

レスポンスの例

HTTP 200 OK

{
  "id": "sess_xxx",
  "type": "session",
  "identity_id": "idn_xxx",
  "template": {
    "id": "tmpl_support",
    "type": "template",
    "name": "Support assistant",
    "model": "ultimate",
    "version": 3
  },
  "source_type": "api",
  "status": "idle",
  "title": "Updated session title",
  "metadata": {
    "source": "mobile",
    "biz_id": "ticket_123"
  },
  "stats": {
    "active_seconds": 30,
    "duration_seconds": 3600
  },
  "usage": {
    "credits": 12.7
  },
  "archived_at": null,
  "created_at": "2026-06-22T10:00:00Z",
  "updated_at": "2026-06-22T12:00:00Z"
}

レスポンスフィールド

更新後のセッションオブジェクトを返します。

エラー

HTTP	タイプ	コード	トリガー
400	invalid_request_error	invalid_request	更新ボディが無効です。
401	authentication_error	authentication_required	PAT が無効、または期限切れです。
404	not_found_error	session_not_found	セッションが存在しません。
409	conflict_error	session_archived	セッションはアーカイブ済みです。

注記

• config、resources、incremental_streaming_enabled は作成時に設定されるため、ここでは変更できません。