List connected agents
curl --request GET \
--url https://core.cyberun.cloud/api/v1/agents \
--header 'Authorization: Bearer <token>'import requests
url = "https://core.cyberun.cloud/api/v1/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/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/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/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/agents")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.cyberun.cloud/api/v1/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
Returns agents currently registered for this team via WebSocket. Data is read from the the platform’s runtime state (the cache), not from a database. Maximum 500 agents scanned. Supports pagination.
GET
/
agents
List connected agents
curl --request GET \
--url https://core.cyberun.cloud/api/v1/agents \
--header 'Authorization: Bearer <token>'import requests
url = "https://core.cyberun.cloud/api/v1/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/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/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/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/agents")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.cyberun.cloud/api/v1/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
bearerAuthDeviceAuth
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
