curl --request GET \
--url https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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{
"budget_used_nanos": "<string>",
"created_at": 123,
"definition": {
"config": {
"name": "<string>",
"x-agentsfleet": {
"budget": {
"daily_nanos": "<string>",
"monthly_nanos": "<string>"
},
"tools": [
"<string>"
],
"context": {
"context_cap_tokens": 1,
"memory_checkpoint_every": 1,
"stage_chunk_threshold": 0.5,
"tool_window": 1
},
"credentials": [
"<string>"
],
"gates": {
"anomaly_rules": [
{
"pattern": "same_action",
"threshold_count": 5000,
"threshold_window_s": 43200
}
],
"rules": [
{
"action": "<string>",
"tool": "<string>",
"behavior": "approve",
"blast_radius": "<string>",
"condition": "<string>",
"gate_kind": "<string>"
}
],
"timeout_ms": 123
},
"model": "<string>",
"network": {
"allow": [
"<string>"
],
"read_only": true,
"read_post_paths": [
"<string>"
]
},
"repositories": [
"<string>"
],
"repository_access": "read",
"repository_base": "<string>",
"triggers": [
{
"source": "<string>",
"type": "webhook",
"credential_name": "<string>",
"events": [
"<string>"
],
"repositories": [
"<string>"
],
"signature": {
"secret_ref": "<string>"
}
}
]
}
},
"description": "<string>",
"instructions_md": "<string>",
"schema_version": 1
},
"etag": "<string>",
"events_processed": "<string>",
"id": "<string>",
"memory_access": {
"publish": true,
"read": true
},
"name": "<string>",
"needs_re_review": true,
"pending_approvals": 123,
"policy_semantics": "<string>",
"schedules": [
{}
],
"setup": {},
"setup_etag": "<string>",
"setup_revision": "<string>",
"start": {},
"status": "<string>",
"updated_at": 123,
"webhook_urls": [
{
"source": "<string>",
"url": "<string>"
}
]
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}Read fleet setup and progress
curl --request GET \
--url https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleets/{fleet_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{
"budget_used_nanos": "<string>",
"created_at": 123,
"definition": {
"config": {
"name": "<string>",
"x-agentsfleet": {
"budget": {
"daily_nanos": "<string>",
"monthly_nanos": "<string>"
},
"tools": [
"<string>"
],
"context": {
"context_cap_tokens": 1,
"memory_checkpoint_every": 1,
"stage_chunk_threshold": 0.5,
"tool_window": 1
},
"credentials": [
"<string>"
],
"gates": {
"anomaly_rules": [
{
"pattern": "same_action",
"threshold_count": 5000,
"threshold_window_s": 43200
}
],
"rules": [
{
"action": "<string>",
"tool": "<string>",
"behavior": "approve",
"blast_radius": "<string>",
"condition": "<string>",
"gate_kind": "<string>"
}
],
"timeout_ms": 123
},
"model": "<string>",
"network": {
"allow": [
"<string>"
],
"read_only": true,
"read_post_paths": [
"<string>"
]
},
"repositories": [
"<string>"
],
"repository_access": "read",
"repository_base": "<string>",
"triggers": [
{
"source": "<string>",
"type": "webhook",
"credential_name": "<string>",
"events": [
"<string>"
],
"repositories": [
"<string>"
],
"signature": {
"secret_ref": "<string>"
}
}
]
}
},
"description": "<string>",
"instructions_md": "<string>",
"schema_version": 1
},
"etag": "<string>",
"events_processed": "<string>",
"id": "<string>",
"memory_access": {
"publish": true,
"read": true
},
"name": "<string>",
"needs_re_review": true,
"pending_approvals": 123,
"policy_semantics": "<string>",
"schedules": [
{}
],
"setup": {},
"setup_etag": "<string>",
"setup_revision": "<string>",
"start": {},
"status": "<string>",
"updated_at": 123,
"webhook_urls": [
{
"source": "<string>",
"url": "<string>"
}
]
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": 123,
"resolved_by": "<string>",
"user_message": "<string>"
}Authorizations
Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth
Path Parameters
UUIDv7 of the workspace.
UUIDv7 of the fleet.
Response
Current fleet
Shared fleet resource, returned by create, read and lifecycle changes.
Exact lifetime spend in nanos.
Creation time in Unix milliseconds.
Complete validated native setup, with no private transcript.
Show child attributes
Show child attributes
Strong resource tag for name/status changes.
Exact lifetime event count.
Fleet identity.
Current independent shared-memory permissions.
Show child attributes
Show child attributes
Validated instance slug.
Effective authority changed since review.
Current unanswered approval gates.
Pinned policy interpretation.
Actual stored schedule observations.
Live prerequisites and authorized recovery actions.
Strong setup tag for reviewed improvement application.
Exact decimal immutable setup revision.
Explicit initial-run progress.
Current lifecycle state.
Last mutation in Unix milliseconds.
Manual webhook addresses from the declared setup.
Show child attributes
Show child attributes