メインコンテンツへスキップ
GET /api/v1/cloud/agents/{agent_id}/versions 指定された Agent のバージョン履歴を取得します。バージョン番号の降順(最新バージョンが先頭)で返されます。

リクエストヘッダー

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

パスパラメーター

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

クエリパラメーター

パラメーター必須デフォルト説明
limitintegerいいえ201ページあたりの返却件数。範囲は 1〜100。100 を超える値は 400 invalid_request_error を返します
pagestringいいえ-前回のレスポンスの next_page で返されたカーソル
ページネーションの詳細についてはページネーションを参照してください。

リクエスト例

curl -X GET "https://api.qoder.com/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": "Used for API documentation testing",
      "model": "ultimate",
      "system": "You are an updated documentation testing assistant.",
      "tools": [],
      "mcp_servers": [],
      "skills": [],
      "metadata": {},
      "multiagent": null,
      "version": 2,
      "archived_at": null,
      "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": "You are a documentation testing assistant.",
      "tools": [],
      "mcp_servers": [],
      "skills": [],
      "metadata": {},
      "multiagent": null,
      "version": 1,
      "archived_at": null,
      "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,
  "next_page": null
}

レスポンスフィールド

フィールド説明
dataAgent version snapshot の配列現在のページのバージョンスナップショット
first_idstring現在のページの最初のレコードのバージョン識別子
last_idstring現在のページの最後のレコードのバージョン識別子
has_morebooleanさらにバージョンレコードが存在するかどうか
next_pagestring|null次ページのカーソル。has_more が true の場合は last_id と同じ値、それ以外は null

バージョン履歴について

  • Agent の作成時に version 1 が保存されます
  • Agent を更新するたびに次のバージョンが保存されます
  • 各バージョンにはその時点の Agent の完全なスナップショットが保存されます
  • 変更履歴の監査やロールバック時の参照に利用できます

エラー

HTTPtype発生条件
400invalid_request_errorlimit が正の整数ではない
400invalid_request_errorページネーションカーソルが不正
400invalid_request_errorpage が正の整数のバージョンカーソルではない
401authentication_errorPAT が無効または有効期限切れ
403permission_errorこの Agent へのアクセス権限がない
404not_found_error指定された ID の Agent が存在しない
エラーエンベロープの詳細についてはエラーを参照してください。

注意事項

  • このエンドポイントでは、first_idlast_id はバージョン番号の文字列表現です(例: "1""2"
  • デフォルトではバージョン番号の降順で、最新バージョンが先頭に表示されます
  • Agent のアーカイブでは新しいバージョンスナップショットは作成されません
  • POST /api/v1/cloud/agents/{agent_id} の OCC メカニズムと組み合わせて、設定変更履歴を追跡できます

関連

Agent の定義

再利用可能でバージョン管理された Agent 構成を作成する。