Pular para o conteúdo principal
GET
/
agents
/
{id}
/
versions
Listar Versões do Agente
curl --request GET \
  --url https://api.tess.im/agents/{id}/versions \
  --header 'Authorization: Bearer <token>'

​
Exemplos 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 do workspace. Se não fornecido, o workspace selecionado pelo usuário será utilizado.
Nota: Este campo será obrigatório em uma versão futura da API. É altamente recomendado defini-lo agora para garantir compatibilidade com atualizações futuras.

​
Parâmetros de Caminho

​
id
integer
obrigatório
O ID do agente

​
Parâmetros de Query

ParâmetroTipoObrigatórioDescrição
pageintegerNãoPágina atual (padrão: 1)
per_pageintegerNãoNúmero de itens por página (padrão: 20)

​
Resposta

{
  "versions": [
    {
      "version_id": 9,
      "published_at": "2026-04-09T14:30:00+00:00",
      "published_by": "usuario@exemplo.com",
      "rollback_from_version": 5,
      "change_summary": "",
      "diff": []
    },
    {
      "version_id": 7,
      "published_at": "2026-04-06T13:52:19+00:00",
      "published_by": "usuario@exemplo.com",
      "rollback_from_version": 2,
      "change_summary": "instructions, ask_user_questions",
      "diff": {
        "instructions": {
          "previous_version": "Você é um assistente útil.",
          "current_version": "Você é um assistente de suporte ao cliente."
        },
        "ask_user_questions": {
          "previous_version": [],
          "current_version": [
            {
              "name": "topico",
              "type": "text",
              "description": "Sobre qual assunto você precisa de ajuda?",
              "required": true,
              "tooltip": ""
            }
          ]
        }
      }
    },
    {
      "version_id": 1,
      "published_at": "2026-04-02T17:52:17+00:00",
      "published_by": "usuario@exemplo.com",
      "rollback_from_version": null,
      "change_summary": "",
      "diff": []
    }
  ],
  "current_version_number": 9,
  "meta": {
    "total": 9,
    "page": 1,
    "per_page": 20
  }
}

​
Campos da Resposta

CampoTipoDescrição
versionsarrayLista de versões do agente
current_version_numberintegerO version_id da versão atualmente ativa
meta.totalintegerTotal de versões
meta.pageintegerPágina atual
meta.per_pageintegerNúmero de itens por página
version_idintegerIdentificador sequencial único desta versão
published_bystringE-mail do usuário que salvou esta versão
published_atstring (ISO8601)Timestamp de quando esta versão foi criada
rollback_from_versioninteger | nullSe esta versão foi criada por um rollback, o version_id de origem; caso contrário null
change_summarystringLista separada por vírgulas dos campos alterados em relação à versão anterior. String vazia quando não há alterações
diffobject | arrayDiff campo a campo em relação à versão anterior. Cada chave contém previous_version e current_version. Retorna array vazio [] quando não há alterações