Saltar al contenido principal
GET
/
agents
/
{id}
/
versions
Listar Versiones del Agente
curl --request GET \
  --url https://api.tess.im/agents/{id}/versions \
  --header 'Authorization: Bearer <token>'

​
Ejemplos de Código

curl --request GET \
  --url 'https://api.tess.im/agents/8794/versions' \
  --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

​
Parámetros de Query

ParámetroTipoRequeridoDescripción
pageintegerNoPágina actual (predeterminado: 1)
per_pageintegerNoNúmero de elementos por página (predeterminado: 20)

​
Respuesta

{
  "versions": [
    {
      "version_id": 9,
      "published_at": "2026-04-09T14:30:00+00:00",
      "published_by": "usuario@ejemplo.com",
      "rollback_from_version": 5,
      "change_summary": "",
      "diff": []
    },
    {
      "version_id": 7,
      "published_at": "2026-04-06T13:52:19+00:00",
      "published_by": "usuario@ejemplo.com",
      "rollback_from_version": 2,
      "change_summary": "instructions, ask_user_questions",
      "diff": {
        "instructions": {
          "previous_version": "Eres un asistente útil.",
          "current_version": "Eres un asistente de soporte al cliente."
        },
        "ask_user_questions": {
          "previous_version": [],
          "current_version": [
            {
              "name": "tema",
              "type": "text",
              "description": "¿Con qué tema necesitas ayuda?",
              "required": true,
              "tooltip": ""
            }
          ]
        }
      }
    },
    {
      "version_id": 1,
      "published_at": "2026-04-02T17:52:17+00:00",
      "published_by": "usuario@ejemplo.com",
      "rollback_from_version": null,
      "change_summary": "",
      "diff": []
    }
  ],
  "current_version_number": 9,
  "meta": {
    "total": 9,
    "page": 1,
    "per_page": 20
  }
}

​
Campos de la Respuesta

CampoTipoDescripción
versionsarrayLista de versiones del agente
current_version_numberintegerEl version_id de la versión actualmente activa
meta.totalintegerTotal de versiones
meta.pageintegerPágina actual
meta.per_pageintegerNúmero de elementos por página
version_idintegerIdentificador secuencial único de esta versión
published_bystringEmail del usuario que guardó esta versión
published_atstring (ISO8601)Timestamp de cuándo se creó esta versión
rollback_from_versioninteger | nullSi esta versión fue creada por un rollback, el version_id de origen; de lo contrario null
change_summarystringLista separada por comas de los campos modificados respecto a la versión anterior. Cadena vacía si no hubo cambios
diffobject | arrayDiff campo a campo respecto a la versión anterior. Cada clave contiene previous_version y current_version. Devuelve array vacío [] si no hubo cambios