> ## Documentation Index > Fetch the complete documentation index at: https://docs.tess.im/llms.txt > Use this file to discover all available pages before exploring further. # Listar Versiones del Agente > Devuelve una lista paginada de todas las versiones guardadas de un agente específico, incluyendo el diff campo a campo y el `change_summary` de cada versión respecto a la anterior. Requiere el permiso `agent:version:read`. ### **Ejemplos de Código** ```http cURL theme={null} curl --request GET \ --url 'https://api.tess.im/agents/8794/versions' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'x-workspace-id: YOUR_WORKSPACE_ID' ``` ```json Node.js theme={null} const axios = require('axios'); const config = { method: 'get', url: 'https://api.tess.im/agents/8794/versions', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'x-workspace-id': 'YOUR_WORKSPACE_ID' } }; try { const response = await axios(config); console.log(response.data); } catch (error) { console.error(error); } ``` ```python Python theme={null} import requests url = "https://api.tess.im/agents/8794/versions" headers = { "Authorization": "Bearer YOUR_API_KEY", "x-workspace-id": "YOUR_WORKSPACE_ID" } response = requests.get(url, headers=headers) print(response.json()) ``` ```php PHP theme={null} "https://api.tess.im/agents/8794/versions", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "x-workspace-id: YOUR_WORKSPACE_ID" ] ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "Error: " . $err; } else { echo $response; } ``` ```java Java theme={null} import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.tess.im/agents/8794/versions")) .header("Authorization", "Bearer YOUR_API_KEY") .header("x-workspace-id", "YOUR_WORKSPACE_ID") .GET() .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); ``` ```go Go theme={null} package main import ( "fmt" "io/ioutil" "net/http" ) func main() { client := &http.Client{} req, err := http.NewRequest("GET", "https://api.tess.im/agents/8794/versions", nil) if err != nil { fmt.Println(err) return } req.Header.Add("Authorization", "Bearer YOUR_API_KEY") req.Header.Add("x-workspace-id", "YOUR_WORKSPACE_ID") resp, err := client.Do(req) if err != nil { fmt.Println(err) return } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` ```jsonnet .NET theme={null} using System; using System.Net.Http; using System.Threading.Tasks; class Program { static async Task Main(string[] args) { using (var client = new HttpClient()) { client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY"); client.DefaultRequestHeaders.Add("x-workspace-id", "YOUR_WORKSPACE_ID"); try { var response = await client.GetAsync("https://api.tess.im/agents/8794/versions"); response.EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } catch(HttpRequestException e) { Console.WriteLine("\nException Caught!"); Console.WriteLine("Message :{0} ", e.Message); } } } } ``` ```ruby Ruby theme={null} require 'uri' require 'net/http' require 'json' uri = URI('https://api.tess.im/agents/8794/versions') http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = true request = Net::HTTP::Get.new(uri) request['Authorization'] = 'Bearer YOUR_API_KEY' request['x-workspace-id'] = 'YOUR_WORKSPACE_ID' response = http.request(request) puts response.read_body ``` ### **Encabezados** ID del workspace. **Obligatorio a partir del 01/09/2026.** Hasta entonces, si se omite, se usa el workspace seleccionado del usuario (deprecated). Después de la fecha, ausencia → **422**. ### **Parámetros de Ruta** El ID del agente ### **Parámetros de Query** | **Parámetro** | **Tipo** | **Requerido** | **Descripción** | | :------------ | :------- | :------------ | :-------------------------------------------------- | | page | integer | No | Página actual (predeterminado: 1) | | per\_page | integer | No | Número de elementos por página (predeterminado: 20) | ### **Respuesta** ```json theme={null} { "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** | **Campo** | **Tipo** | **Descripción** | | :----------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | | versions | array | Lista de versiones del agente | | current\_version\_number | integer | El `version_id` de la versión actualmente activa | | meta.total | integer | Total de versiones | | meta.page | integer | Página actual | | meta.per\_page | integer | Número de elementos por página | | version\_id | integer | Identificador secuencial único de esta versión | | published\_by | string | Email del usuario que guardó esta versión | | published\_at | string (ISO8601) | Timestamp de cuándo se creó esta versión | | rollback\_from\_version | integer \| null | Si esta versión fue creada por un rollback, el `version_id` de origen; de lo contrario `null` | | change\_summary | string | Lista separada por comas de los campos modificados respecto a la versión anterior. Cadena vacía si no hubo cambios | | diff | object \| array | Diff 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 |