メインコンテンツへスキップ
POST /api/v1/cloud/sessions/{session_id} Session の可変属性を更新します。省略したフィールドは保持されます。

​
パスパラメータ

パラメータ型説明
session_idstringsess_ プレフィックスを持つ Session ID

​
ヘッダー

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

​
リクエストボディ

フィールド型必須説明
titlestring | nullいいえ新しい Session タイトル。クリアするには null を送信します
metadataobject | nullいいえメタデータパッチ。値が null のオブジェクトキーはそのキーを削除します。トップレベルの null は現在 no-op です
agentobjectいいえSession 途中の Agent 更新。tools と mcp_servers のみサポートされ、指定された場合はそれぞれ完全置換となります
注意: vault_ids は公開 Session 形式に現れますが、現在このエンドポイントでは書き込みできません — リクエストは拒否されます。読み取り時のみ使用してください。サポートされるリクエストボディの一部ではありません。delta_flush_interval_ms もサポートされません。

​
リクエスト例

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

​
レスポンス例

HTTP 200 OK 更新後の Session オブジェクトを返します。

​
エラー

HTTPType発生条件
400invalid_request_errorリクエストボディの形式エラー、サポートされないフィールド、またはサポートされない Agent 更新フィールド
401authentication_errorPAT が無効または期限切れ
404not_found_errorSession が存在しない
HTTP 400 Bad Request 
{
  "type": "error",
  "request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
  "error": {
    "type": "invalid_request_error",
    "message": "metadata must be an object"
  }
}
HTTP 404 Not Found 
{
  "type": "error",
  "request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
  "error": {
    "type": "not_found_error",
    "message": "Session 'sess_does_not_exist_0000000000000000000000000000' was not found."
  }
}
完全なエラーエンベロープについては Errors を参照してください。

​
関連項目

Session の起動

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