cURL

curl 'https://api.gumloop.com/api/v1/agents/abc123DEFghiJKL/versions/gv_a1b2c3d4' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

from gumloop import Gumloop

client = Gumloop(access_token="YOUR_ACCESS_TOKEN")

response = client.agents.get_version("abc123DEFghiJKL", "gv_a1b2c3d4")
print(response.version.composition.system_prompt)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}",
  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 <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "version": {
    "id": "gv_a1b2c3d4",
    "agent_id": "abc123DEFghiJKL",
    "major_version": 3,
    "name": "Sales research agent",
    "is_deployed": true,
    "created_at": "2026-05-16T09:10:00Z",
    "creator": {
      "id": "user_8c2a1b",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "profile_picture": null
    },
    "composition": {
      "complete": true,
      "schema_version": 1,
      "name": "Sales research agent",
      "description": "Researches accounts and drafts outreach",
      "model_name": "anthropic/claude-sonnet-4",
      "system_prompt": "You are a B2B sales research assistant.",
      "tools": [],
      "resources": [],
      "metadata": {},
      "skill_ids": [
        "skill_2b9c"
      ],
      "knowledge_sources": []
    }
  },
  "changes": {
    "base_version_id": "gv_e5f6g7h8",
    "attachment_changes_complete": true,
    "field_changes": [
      {
        "field": "system_prompt",
        "status": "modified",
        "text_hunks": [
          {
            "old_start": 0,
            "old_end": 1,
            "new_start": 0,
            "new_end": 1,
            "old_text": "You are a sales assistant.",
            "new_text": "You are a B2B sales research assistant."
          }
        ]
      }
    ],
    "tool_changes": [],
    "skill_changes": [
      {
        "skill_id": "skill_2b9c",
        "status": "added"
      }
    ],
    "knowledge_source_changes": []
  }
}

Retrieve agent version

Retrieve one immutable agent version: its full configuration (composition) plus the structured changes relative to the version before it. Use it to export an agent’s configuration or to audit what changed between versions.

changes is null for the first version of an agent, since there is no predecessor to diff against. Versions created before attachment snapshots were recorded report composition.complete: false (and changes.attachment_changes_complete: false); their skill_ids and knowledge_sources are null rather than empty. Skill file contents are never included, and this endpoint is read-only — it cannot restore or deploy a version.

Requires configuration access on the agent — callers limited to using the agent (no configuration access) get a 403.

GET

agents

{agent_id}

versions

{version_id}

cURL

curl 'https://api.gumloop.com/api/v1/agents/abc123DEFghiJKL/versions/gv_a1b2c3d4' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

from gumloop import Gumloop

client = Gumloop(access_token="YOUR_ACCESS_TOKEN")

response = client.agents.get_version("abc123DEFghiJKL", "gv_a1b2c3d4")
print(response.version.composition.system_prompt)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}",
  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 <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gumloop.com/api/v1/agents/{agent_id}/versions/{version_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "version": {
    "id": "gv_a1b2c3d4",
    "agent_id": "abc123DEFghiJKL",
    "major_version": 3,
    "name": "Sales research agent",
    "is_deployed": true,
    "created_at": "2026-05-16T09:10:00Z",
    "creator": {
      "id": "user_8c2a1b",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "profile_picture": null
    },
    "composition": {
      "complete": true,
      "schema_version": 1,
      "name": "Sales research agent",
      "description": "Researches accounts and drafts outreach",
      "model_name": "anthropic/claude-sonnet-4",
      "system_prompt": "You are a B2B sales research assistant.",
      "tools": [],
      "resources": [],
      "metadata": {},
      "skill_ids": [
        "skill_2b9c"
      ],
      "knowledge_sources": []
    }
  },
  "changes": {
    "base_version_id": "gv_e5f6g7h8",
    "attachment_changes_complete": true,
    "field_changes": [
      {
        "field": "system_prompt",
        "status": "modified",
        "text_hunks": [
          {
            "old_start": 0,
            "old_end": 1,
            "new_start": 0,
            "new_end": 1,
            "old_text": "You are a sales assistant.",
            "new_text": "You are a B2B sales research assistant."
          }
        ]
      }
    ],
    "tool_changes": [],
    "skill_changes": [
      {
        "skill_id": "skill_2b9c",
        "status": "added"
      }
    ],
    "knowledge_source_changes": []
  }
}

Authorizations

Authorization

string

header

required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Path Parameters

agent_id

string

required

ID of the agent the version belongs to.

version_id

string

required

ID of the version to retrieve, from GET /agents/{agent_id}/versions.

Response

The requested agent version.

version

object

Show child attributes

changes

object | null

Structured diff against the preceding version. null for the agent's first version.

Show child attributes

⌘I

Core Concepts

SDKs

Agents

Sessions

Skills

Artifacts

MCP

Evaluations

Brain

Teams

Chat completions

Models

Retrieving Automations

File Operations

Enterprise Organization

Running Flows

Retrieve agent version

Authorizations

Path Parameters

Response