Agent バージョンのロールバック

指定した Agent の履歴バージョンをロールバックして新しいバージョンとして保存し、任意で即時公開できます。

本インターフェースは対象 Agent 自身の API Key で認証を行い、バージョン管理権限を有効化した Agent のみが呼び出せます。

リクエストメソッド

POST

リクエストURL

https://api.${endpoint}/v1/agent/version/rollback

リクエスト認証

詳しくは API 概要の認証方式の説明をご参照ください。対象 Agent の API Key を token として使用してください。

リクエスト

リクエスト例

curl -X POST 'https://api.${endpoint}/v1/agent/version/rollback' \ -H 'Authorization: Bearer ${token}' \ -H 'Content-Type: application/json' \ -d '{ "version": "v1", "new_version": "v3", "release": true, "version_desc": "Rollback to stable prompt" }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/version/rollback' \
  -H 'Authorization: Bearer ${token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "version": "v1",
    "new_version": "v3",
    "release": true,
    "version_desc": "Rollback to stable prompt"
  }'

このコードブロックをポップアップで表示

リクエストヘッダー

フィールド	タイプ	説明
Authorization	Bearer ${token}	対象 Agent の API Key を使用して呼び出しを検証します。
Content-Type	application/json	リクエストボディの形式。

リクエストパラメータ（Body Parameters）

パラメータ	タイプ	説明	required
version	String	ロールバック元のバージョン番号。	true
new_version	String	ロールバック後に保存する新しいバージョン番号。空の場合は自動生成されます。	false
release	Boolean	ロールバック保存後に即時公開するかどうか。	false
version_desc	String	新しいバージョンの説明。	false

レスポンス

レスポンスボディ

{ "code": 0, "message": "OK", "data": { "source_version": "v1", "new_version": "v3", "created": true, "released": true, "warnings": [] } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "source_version": "v1",
    "new_version": "v3",
    "created": true,
    "released": true,
    "warnings": []
  }
}

このコードブロックをポップアップで表示

成功時のレスポンス

フィールド	タイプ	説明
source_version	String	ロールバック元のバージョン番号。
new_version	String	保存された新しいバージョン番号。
created	Boolean	新しいバージョンを作成したかどうか。
released	Boolean	公開済みかどうか。
warnings	String[]	ロールバックに関する注意事項。

エラー時のレスポンス

フィールド	タイプ	説明
code	int	エラーコード。
message	string	エラー情報。

ステータスコード

ステータスコード	説明
200	成功
400	パラメータエラー
401	未認証
403	権限不足、または API Key でバージョン管理権限が有効化されていません
429	リクエストが頻繁すぎます
500	サーバーエラー