メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

GET /v1/agents/{agent_id}/versions 指定された Agent のバージョン履歴を取得します。バージョン番号の降順（最新バージョンが先頭）でソートされます。

​
ヘッダー

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

​
パスパラメータ

パラメータ型必須説明
agent_idstringはいAgent の一意識別子

​
クエリパラメータ

パラメータ型必須デフォルト値説明
limitintegerいいえ201 ページあたりの返却件数
orderstringいいえdescソート方向、asc または desc
after_idstringいいえ-カーソルページング、このバージョンより後のレコードを返す
before_idstringいいえ-カーソルページング、このバージョンより前のレコードを返す

​
リクエスト例

curl -X GET "https://openapi.qoder.sh/api/v1/cloud/agents/agent_019eXXXX.../versions" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "data": [
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent-updated",
      "description": "API ドキュメントテスト用",
      "model": "ultimate",
      "system": "あなたは更新後のドキュメントテストアシスタントです",
      "instructions": "あなたは更新後のドキュメントテストアシスタントです",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 2,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:27:07.967138Z"
    },
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent",
      "description": "",
      "model": "ultimate",
      "system": "あなたはドキュメントテストアシスタントです",
      "instructions": "あなたはドキュメントテストアシスタントです",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 1,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:26:39.61669Z"
    }
  ],
  "first_id": "2",
  "last_id": "1",
  "has_more": false
}

​
レスポンスフィールド

フィールド型説明
dataarrayAgent バージョンのスナップショット配列。各要素はそのバージョン時点の完全な Agent オブジェクト
first_idstring現在のページの最初のレコードのバージョン識別子
last_idstring現在のページの最後のレコードのバージョン識別子
has_morebooleanさらにバージョンレコードがあるかどうか

​
バージョン履歴の説明

  • PUT で Agent を更新するたびに新しいバージョンが作成されます。
  • バージョン番号は 1 から開始してインクリメントされます。
  • 各バージョンは、その時点の完全な Agent スナップショットを保存します。
  • 変更履歴の監査やロールバック参照に利用できます。

​
エラーコード

HTTPtypeトリガー条件
401authentication_errorPAT が無効または期限切れ
403permission_errorこの Agent にアクセスする権限がない
404not_found_error指定 ID の Agent が存在しない

​
注意事項

  • このエンドポイントの first_id と last_id はバージョン番号の文字列形式に対応します（例: "1"、"2"）。
  • デフォルトはバージョン番号の降順、最新バージョンが先頭です。
  • PUT 操作の OCC 機構と組み合わせて、設定変更履歴をトレースできます。