Saltar al contenido principal
POST
/
agents
/
{id}
/
versions
/
{version_number}
/
rollback
Rollback de Versión del Agente
curl --request POST \
  --url https://api.tess.im/agents/{id}/versions/{version_number}/rollback \
  --header 'Authorization: Bearer <token>'
Intentar hacer rollback a la versión actualmente activa devuelve un error 422.

​
Ejemplos de Código

curl --request POST \
  --url 'https://api.tess.im/agents/8794/versions/2/rollback' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Headers

​
x-workspace-id
integer
ID del workspace. Si no se proporciona, se usará el workspace seleccionado por el usuario.
Nota: Este campo será obligatorio en una versión futura de la API. Se recomienda establecerlo ahora para garantizar compatibilidad con futuras actualizaciones.

​
Parámetros de Ruta

​
id
integer
requerido
El ID del agente
​
version_id
integer
requerido
El ID de la versión a la que hacer rollback

​
Respuesta

{
  "version": {
    "version_id": 10,
    "published_at": "2026-04-09T15:00:00+00:00",
    "published_by": "usuario@ejemplo.com",
    "rollback_from_version": 8,
    "snapshot": {
      "agent_name": "Agente de Soporte al Cliente",
      "instructions": "Eres un asistente de soporte al cliente.",
      "ask_user_questions": [],
      "steps": [],
      "knowledge_base_files": [],
      "type": "chat",
      "subtype": "All LLM Models",
      "advanced_settings": {
        "model": "auto",
        "temperature": "1"
      },
      "visibility": "private"
    }
  },
  "message": "Agent rolled back to version 8. New version 10 is now active."
}

​
Campos de la Respuesta

CampoTipoDescripción
messagestringMensaje de confirmación indicando la versión de origen y la nueva versión activa
version.version_idintegerEl nuevo ID de versión creado por este rollback
version.published_bystringEmail del usuario que realizó el rollback
version.published_atstring (ISO8601)Timestamp de cuándo se creó la versión de rollback
version.rollback_from_versionintegerEl version_id utilizado como origen para este rollback
version.snapshotobjectEstado completo del agente restaurado por este rollback (misma estructura que Get Agent Version)

​
Respuestas de Error

​
Versión Ya Activa (422)

{
  "message": "Cannot roll back to the current active version."
}

​
No Encontrado (404)

{
  "message": "Version not found."
}

​
Prohibido (403)

{
  "message": "You do not have permission to roll back agent versions."
}