List Superagents
curl --request GET \
--url https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents \
--header 'api_key: <api-key>'import requests
url = "https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents', 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://app.base44.com/api/v1/monitoring/{workspace_id}/superagents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api_key: <api-key>"
],
]);
$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://app.base44.com/api/v1/monitoring/{workspace_id}/superagents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents")
.header("api_key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"superagents": [
{
"superagent_id": "agent_abc123",
"superagent_name": "Support Agent",
"active_users_last_30d": 89,
"message_credits_consumed": 4250,
"integration_credits_consumed": 875,
"total_credits_consumed": 5125,
"owner_user_id": "user_abc123",
"created_by_email": "jane.doe@company.com",
"created_at": "2025-01-10T14:30:00Z"
}
],
"pagination": {
"total": 156,
"limit": 50,
"has_more": true,
"next_cursor": "eyJsYXN0X2lkIjoiMTIzIn0="
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}superagents
List Superagents
Returns a paginated workspace-wide Superagent inventory with owner, activity, and credit-usage metrics.
Filter by visibility or search Superagents by name and creator email.
GET
/
{workspace_id}
/
superagents
List Superagents
curl --request GET \
--url https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents \
--header 'api_key: <api-key>'import requests
url = "https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents', 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://app.base44.com/api/v1/monitoring/{workspace_id}/superagents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api_key: <api-key>"
],
]);
$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://app.base44.com/api/v1/monitoring/{workspace_id}/superagents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents")
.header("api_key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/v1/monitoring/{workspace_id}/superagents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"superagents": [
{
"superagent_id": "agent_abc123",
"superagent_name": "Support Agent",
"active_users_last_30d": 89,
"message_credits_consumed": 4250,
"integration_credits_consumed": 875,
"total_credits_consumed": 5125,
"owner_user_id": "user_abc123",
"created_by_email": "jane.doe@company.com",
"created_at": "2025-01-10T14:30:00Z"
}
],
"pagination": {
"total": 156,
"limit": 50,
"has_more": true,
"next_cursor": "eyJsYXN0X2lkIjoiMTIzIn0="
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
API key for authentication. See the Authentication page for your API for details on how to get your key.
Path Parameters
Query Parameters
Items per page. Max 50.
Required range:
1 <= x <= 50Pagination cursor from previous response.
Start date in YYYY-MM-DD format. Required if to is provided. Defaults to billing period start.
End date in YYYY-MM-DD format. Required if from is provided. Defaults to current date.
Sort field. Prefix with - for descending. Supported fields: "superagent_name", "created_at", "created_by_email", "owner_user_id", "active_users_last_30d", "message_credits_consumed", "integration_credits_consumed", "total_credits_consumed".
Case-insensitive search over Superagent name and creator email.
Maximum string length:
100Filter by Superagent visibility. Accepts "private", "workspace", "public_with_login", "public_without_login", or "public".
Was this page helpful?