Retrieve agent version

cURL

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

from orchestrivo import Orchestrivo

client = Orchestrivo(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.orchestrivo.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.orchestrivo.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.orchestrivo.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.orchestrivo.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": []
  }
}

GET

agents

{agent_id}

versions

{version_id}

cURL

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

from orchestrivo import Orchestrivo

client = Orchestrivo(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.orchestrivo.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.orchestrivo.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.orchestrivo.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.orchestrivo.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": []
  }
}

Why are some fields null?

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.

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. Also accepts the reserved aliases orchestrivoassistant and analytics.

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

Core concepts

Agents

Sessions

Skills

Artifacts

MCP

Browser profiles

Personal wiki

Evaluations

Organization evaluations

Brain

Teams

Models

File operations

Enterprise organization

Retrieve agent version

Authorizations

Path Parameters

Response