List connected agents (runtime)
curl --request GET \
--url https://core.cyberun.cloud/api/v1/r/agents \
--header 'Authorization: Bearer <token>'import requests
url = "https://core.cyberun.cloud/api/v1/r/agents"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://core.cyberun.cloud/api/v1/r/agents', 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://core.cyberun.cloud/api/v1/r/agents",
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://core.cyberun.cloud/api/v1/r/agents"
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://core.cyberun.cloud/api/v1/r/agents")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.cyberun.cloud/api/v1/r/agents")
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_list": [
{
"agent_id": "gpu-node-01",
"agent_status": "idle",
"agent_labels": [
"gpu",
"a100",
"comfyui"
],
"last_heartbeat": "2025-02-10T14:30:00Z",
"agent_version": "0.1.3",
"tool": "comfyui",
"tool_version": "0.3.13",
"comfyui_version": "0.3.13",
"gpu_capacity": 8,
"running_count": 3,
"running_tasks": [
"019abc12-9012-7890-abcd-ef1234567896",
"019abc12-9012-7890-abcd-ef1234567897"
],
"platform_arch": "linux/amd64",
"sync_phase": "downloading",
"sync_detail": "Downloading model flux1-dev-fp8 (2.1 GB)",
"sync_percent": 45,
"connected_at": "2025-02-10T14:00:00Z",
"tasks_completed": 42,
"current_task_id": "019abc12-9012-7890-abcd-ef1234567896",
"system_stats": {
"comfyui_version": "0.3.10",
"pytorch_version": "2.5.1+cu124",
"os_type": "posix",
"gpu_devices": [
{
"device_name": "NVIDIA GeForce RTX 4090",
"device_type": "cuda",
"vram_total": 25769803776,
"vram_free": 22548578304
}
]
}
}
],
"page_meta": {
"current_page": 1,
"per_page": 20,
"total_count": 42
}
}{
"error_message": "resource not found"
}{
"error_message": "resource not found"
}{
"error_message": "resource not found"
}Agent
List connected agents (runtime)
Returns agents currently registered for this team via WebSocket.
Identical to the management endpoint but also accepts the runtime credential bearers.
Data is read from the the platform’s runtime state (the cache), not from a database.
Supports pagination. Accepts JWT Bearer, sk- integration credential, or
dk- device credential.
GET
/
r
/
agents
List connected agents (runtime)
curl --request GET \
--url https://core.cyberun.cloud/api/v1/r/agents \
--header 'Authorization: Bearer <token>'import requests
url = "https://core.cyberun.cloud/api/v1/r/agents"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://core.cyberun.cloud/api/v1/r/agents', 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://core.cyberun.cloud/api/v1/r/agents",
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://core.cyberun.cloud/api/v1/r/agents"
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://core.cyberun.cloud/api/v1/r/agents")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.cyberun.cloud/api/v1/r/agents")
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_list": [
{
"agent_id": "gpu-node-01",
"agent_status": "idle",
"agent_labels": [
"gpu",
"a100",
"comfyui"
],
"last_heartbeat": "2025-02-10T14:30:00Z",
"agent_version": "0.1.3",
"tool": "comfyui",
"tool_version": "0.3.13",
"comfyui_version": "0.3.13",
"gpu_capacity": 8,
"running_count": 3,
"running_tasks": [
"019abc12-9012-7890-abcd-ef1234567896",
"019abc12-9012-7890-abcd-ef1234567897"
],
"platform_arch": "linux/amd64",
"sync_phase": "downloading",
"sync_detail": "Downloading model flux1-dev-fp8 (2.1 GB)",
"sync_percent": 45,
"connected_at": "2025-02-10T14:00:00Z",
"tasks_completed": 42,
"current_task_id": "019abc12-9012-7890-abcd-ef1234567896",
"system_stats": {
"comfyui_version": "0.3.10",
"pytorch_version": "2.5.1+cu124",
"os_type": "posix",
"gpu_devices": [
{
"device_name": "NVIDIA GeForce RTX 4090",
"device_type": "cuda",
"vram_total": 25769803776,
"vram_free": 22548578304
}
]
}
}
],
"page_meta": {
"current_page": 1,
"per_page": 20,
"total_count": 42
}
}{
"error_message": "resource not found"
}{
"error_message": "resource not found"
}{
"error_message": "resource not found"
}Authorizations
bearerAuthDeviceAuthApiKeyAuth
User session JWT (Bearer ). Must be paired with the X-Team-ID
request header on team-scoped endpoints so the server knows which
team's resources to operate on.
Headers
UUID of the team to scope the request to. Used by dual-auth endpoints (runtime + scoped management):
- JWT callers MUST send it — a user may belong to multiple teams and the runtime cannot otherwise know which one to operate on. Missing header → 400.
- Credential callers (
sk-,dk-) can omit it because the team is derived from the credential row itself. Any value sent is ignored.
Example:
"019abc12-4567-7890-abcd-ef1234567891"
Query Parameters
Page number to retrieve (1-based). Default: 1.
Required range:
x >= 1Example:
1
Number of items per page (1–100). Default: 20.
Required range:
1 <= x <= 100Example:
20
