Revertir versión de Agent

Permite revertir una versión histórica específica de Agent, guardándola como una nueva versión, con la opción de publicarla de inmediato.

Esta interfaz utiliza la propia API Key del Agent de destino para la autenticación y solo permite la invocación por parte de Agents que tengan habilitado el permiso de gestión de versiones.

Método de solicitud

POST

URL de la solicitud

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

Autenticación de la solicitud

Para más detalles, consulte la descripción del método de autenticación en la Visión general de la API. Utilice la API Key del Agent de destino como token.

Solicitud

Ejemplo de solicitud

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"
  }'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${token}	Utiliza la API Key del Agent de destino para la validación de la llamada.
Content-Type	application/json	Formato del cuerpo de la solicitud.

Parámetros de la solicitud (Body Parameters)

Campo	Tipo	Descripción	Obligatorio
version	String	Número de versión de origen que se va a revertir.	true
new_version	String	Número de la nueva versión que se guardará tras la reversión; si se deja vacío, se genera automáticamente.	false
release	Boolean	Indica si se publica de inmediato tras guardar la reversión.	false
version_desc	String	Descripción de la nueva versión.	false

Respuesta

Cuerpo de la respuesta

{ "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": []
  }
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
source_version	String	Número de versión de origen de la reversión.
new_version	String	Número de la nueva versión guardada.
created	Boolean	Indica si se creó una nueva versión.
released	Boolean	Indica si se ha publicado.
warnings	String[]	Advertencias sobre la reversión.

Respuesta fallida

Campo	Tipo	Descripción
code	int	Código de error.
message	string	Mensaje de error.

Códigos de estado

Código de estado	Descripción
200	Correcto
400	Error de parámetros
401	No autorizado
403	Permisos insuficientes o la API Key no tiene habilitada la gestión de versiones
429	Demasiadas solicitudes
500	Error del servidor