curl --request GET \
--url https://api.sidenet.ai/v1/agents/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sidenet.ai/v1/agents/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sidenet.ai/v1/agents/{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.sidenet.ai/v1/agents/{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.sidenet.ai/v1/agents/{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))
}HttpResponse<String> response = Unirest.get("https://api.sidenet.ai/v1/agents/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sidenet.ai/v1/agents/{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{
"agent": {
"id": "6f1c0f4e-2b7a-4a51-9a2f-0c9d1b3e5a10",
"org_id": "2b9d7c31-8e4f-4a2b-9d61-77c0a3f5e812",
"name": "Support agent",
"description": "Answers billing and account questions",
"active_version_id": "b3f7a2c8-5d19-4e6b-8f02-1a4c9e7d3b55",
"activeVersionNumber": 3,
"latestPublishedVersionNumber": 3,
"draftDirty": true,
"created_at": "2026-07-02T09:14:22.418Z",
"updated_at": "2026-08-11T16:03:47.902Z"
},
"version": {
"id": "b3f7a2c8-5d19-4e6b-8f02-1a4c9e7d3b55",
"agent_id": "6f1c0f4e-2b7a-4a51-9a2f-0c9d1b3e5a10",
"version_number": 3,
"rev": 1,
"instructions": [
{
"type": "prompt_block_ref",
"id": "d41a8f6b-9c27-4b13-a5e8-2f60c1d7b394",
"versionId": "7e2b5a90-3c48-4d61-b9f7-05a8c2e14d6f"
},
{
"type": "text",
"content": "Answer in {{locale || 'English'}}."
}
],
"model_slug": "anthropic/claude-sonnet-4-5",
"model_settings": {
"temperature": 0.2
},
"max_steps": 8,
"agentTools": [
{
"tool_id": "a7c3e1d5-6b48-4f92-8a03-e5c9b2d417f6",
"provider_id": "9c2e4b7a-1d5f-4e83-b6a0-3f7d8c1e2a94",
"tool_name": "List invoices",
"provider_name": "Billing API"
},
{
"tool_id": "showTable",
"provider_id": "rich-ui-components",
"tool_name": "showTable",
"provider_name": "Rich Ui Components"
}
],
"workflows": [],
"agents": [],
"scorers": [],
"memory": null,
"created_at": "2026-08-04T10:22:05.117Z",
"updated_at": "2026-08-04T10:22:05.117Z"
},
"referencedBlocks": [
{
"id": "d41a8f6b-9c27-4b13-a5e8-2f60c1d7b394",
"name": "Brand voice",
"pinnedVersionId": "7e2b5a90-3c48-4d61-b9f7-05a8c2e14d6f",
"pinnedVersionNumber": 2,
"activeVersionId": "7e2b5a90-3c48-4d61-b9f7-05a8c2e14d6f",
"activeVersionNumber": 2,
"outdated": false
}
],
"blocksOutdated": false,
"variables": {
"locale": "English",
"instance": {
"store_count": null
}
}
}Get agent
Returns the agent and exactly ONE of its versions. Which one is up to version; by default it is the active (published) version, falling back to the draft when nothing has been activated yet. The agent object always reports activeVersionNumber, latestPublishedVersionNumber and draftDirty, so a client can tell what else exists — unpublished edits, or a newer published version than the one serving traffic — and ask for it by number in a second call. referencedBlocks and variables describe the version that was returned. variables is the it and its subagents consume, as a nested object mirroring the dot paths — {{instance.store_count}} comes back as {"instance":{"store_count":null}}. Each leaf is the default it renders without a value, or null when it has none (an unsupplied value stays visible in the prompt). Fill the nulls in and send the same object as a chat body’s or an experiment’s variables; leaves left null are ignored.
curl --request GET \
--url https://api.sidenet.ai/v1/agents/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sidenet.ai/v1/agents/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sidenet.ai/v1/agents/{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.sidenet.ai/v1/agents/{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.sidenet.ai/v1/agents/{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))
}HttpResponse<String> response = Unirest.get("https://api.sidenet.ai/v1/agents/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sidenet.ai/v1/agents/{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{
"agent": {
"id": "6f1c0f4e-2b7a-4a51-9a2f-0c9d1b3e5a10",
"org_id": "2b9d7c31-8e4f-4a2b-9d61-77c0a3f5e812",
"name": "Support agent",
"description": "Answers billing and account questions",
"active_version_id": "b3f7a2c8-5d19-4e6b-8f02-1a4c9e7d3b55",
"activeVersionNumber": 3,
"latestPublishedVersionNumber": 3,
"draftDirty": true,
"created_at": "2026-07-02T09:14:22.418Z",
"updated_at": "2026-08-11T16:03:47.902Z"
},
"version": {
"id": "b3f7a2c8-5d19-4e6b-8f02-1a4c9e7d3b55",
"agent_id": "6f1c0f4e-2b7a-4a51-9a2f-0c9d1b3e5a10",
"version_number": 3,
"rev": 1,
"instructions": [
{
"type": "prompt_block_ref",
"id": "d41a8f6b-9c27-4b13-a5e8-2f60c1d7b394",
"versionId": "7e2b5a90-3c48-4d61-b9f7-05a8c2e14d6f"
},
{
"type": "text",
"content": "Answer in {{locale || 'English'}}."
}
],
"model_slug": "anthropic/claude-sonnet-4-5",
"model_settings": {
"temperature": 0.2
},
"max_steps": 8,
"agentTools": [
{
"tool_id": "a7c3e1d5-6b48-4f92-8a03-e5c9b2d417f6",
"provider_id": "9c2e4b7a-1d5f-4e83-b6a0-3f7d8c1e2a94",
"tool_name": "List invoices",
"provider_name": "Billing API"
},
{
"tool_id": "showTable",
"provider_id": "rich-ui-components",
"tool_name": "showTable",
"provider_name": "Rich Ui Components"
}
],
"workflows": [],
"agents": [],
"scorers": [],
"memory": null,
"created_at": "2026-08-04T10:22:05.117Z",
"updated_at": "2026-08-04T10:22:05.117Z"
},
"referencedBlocks": [
{
"id": "d41a8f6b-9c27-4b13-a5e8-2f60c1d7b394",
"name": "Brand voice",
"pinnedVersionId": "7e2b5a90-3c48-4d61-b9f7-05a8c2e14d6f",
"pinnedVersionNumber": 2,
"activeVersionId": "7e2b5a90-3c48-4d61-b9f7-05a8c2e14d6f",
"activeVersionNumber": 2,
"outdated": false
}
],
"blocksOutdated": false,
"variables": {
"locale": "English",
"instance": {
"store_count": null
}
}
}Authorizations
Query Parameters
Which version of the agent to return. Takes any of: a version number (3, or v3); 0 or draft for the unpublished draft; latest for the newest published version; active for the one serving traffic; or the version row's uuid. Defaults to active, falling back to the draft when nothing has been activated yet.
"active"
Response
The agent, the version that was selected, and its variables