Fleet
Mesh view: mesh debug view, fleet rows, token burn, the aggregate poll, owner messages, adapter states, peer reads.
On this page
Mesh status and debug view
/fleet/meshQuery parameters
| Name | Type | Description |
|---|---|---|
debug | string |
|
sinceSeq | integer | Message-log cursor: only newer entries |
Responses
| Status | Description | Body | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | FleetMeshStatus | ||||||||||||||||||
| ||||||||||||||||||||
Errors 400 · 401 · 403
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/mesh" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Fleet status rows
/fleet/statusResponses
| Status | Description | Body | ||||||
|---|---|---|---|---|---|---|---|---|
| 200 | OK | FleetStatus | ||||||
| ||||||||
Errors 401 · 403 · 500
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 500 | Unexpected runtime failure |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/status" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Token burn per agent and fleet
/fleet/burnResponses
| Status | Description | Body | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | FleetBurn | ||||||||||||||||||||||||||||||||||||
fleetrequiredobject | 4 fields of | |||||||||||||||||||||||||||||||||||||
tokensPerMin | number | |
inPerMin | number | |
outPerMin | number | |
totalTokens | number |
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/burn" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Restore lifetime burn totals
/fleet/burn/hydrateThe client keeps the totals across restarts and hands them over once per session; rates start fresh.
Request bodyapplication/json · FleetBurnHydrateBody · required
| Field | Type | Description |
|---|---|---|
burnTotalsrequired | map<string, number> | File path → lifetime tokens (Studio client key fleetMapState.burnTotals) |
Responses
| Status | Description | Body | |||
|---|---|---|---|---|---|
| 200 | OK | SuccessResponse | |||
| |||||
Errors 400 · 401 · 403
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/fleet/burn/hydrate" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
-H "Content-Type: application/json" \
-d '{"burnTotals":{}}'{
"success": true
}Mesh view poll in one call
/fleet/mapQuery parameters
| Name | Type | Description |
|---|---|---|
sinceSeq | integer | Message-log cursor for the debug slice |
Responses
| Status | Description | Body | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | FleetMapPoll | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fleetrequiredobject | Mesh view rows (AgentVitalsService.getFleetStatus) 2 fields of | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
runningrequired | boolean | |
agentsrequired | array<object> |
burnrequired2 fields of burn
perAgentrequired | map<string, FleetBurnEntry> | Keyed by agent file path | ||||||||||||
4 fields of | ||||||||||||||
tokensPerMin | number | |
inPerMin | number | |
outPerMin | number | |
totalTokens | number |
fleetrequired4 fields of fleet · FleetBurnEntry
tokensPerMin | number | |
inPerMin | number | |
outPerMin | number | |
totalTokens | number |
adaptersrequired2 fields of adapters · AdapterStatusSummary
adaptersrequired | array<AdapterState> | One per adapter type, healthiest instance | ||||||||||||||||||||||||||||||
6 fields of | ||||||||||||||||||||||||||||||||
typerequired | string | ||||||||||
statusrequired | string | ||||||||||
error | string | ||||||||||
connectedAt | integer | ||||||||||
restartCountrequired | integer | ||||||||||
logsrequired | array<object> | ||||||||||
3 fields of | |||||||||||
timestamprequired | integer | |
levelrequired | string | |
messagerequired | string |
perAgentrequired2 fields of perAgent
filePathrequired | string | |||||||||||||
adaptersrequired | array<object> | |||||||||||||
4 fields of | ||||||||||||||
type | string | |
status | string | |
error | string | |
connectedAt | number |
peersrequiredErrors 400 · 401 · 403
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/map" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Recent tool calls per agent
/fleet/recent-toolsMesh-registered agents, plus loaded agents the mesh does not track (read from their loops). Keyed by file path.
Responses
| Status | Description | Body | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | RecentMeshToolsResponse | ||||||||||||||||||
| ||||||||||||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/recent-tools" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Owner message to agents
/fleet/messageA chat turn on each running agent. An agent that is not running is started (review gate on, the emergency-stop gate reopened); when the start is refused the message is written into its loop.
Request bodyapplication/json · FleetMessageBody · required
| Field | Type | Description |
|---|---|---|
filePathsrequired | array<string> | |
contentrequired | string |
Responses
| Status | Description | Body | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | FleetMessageResult | |||||||||||||||
| |||||||||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/fleet/message" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filePaths":[],"content":"string"}'Adapter states across loaded agents
/fleet/adaptersResponses
| Status | Description | Body |
|---|---|---|
| 200 | OK | AdapterStatusSummary |
Fields as in AdapterStatusSummary above. | ||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/adapters" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Restart one adapter of an agent
/fleet/adapters/restartRequest bodyapplication/json · AdapterRestartBody · required
| Field | Type | Description |
|---|---|---|
typerequired | string | Adapter type |
filePath | string | The agent hosting the adapter |
Responses
| Status | Description | Body | ||||||
|---|---|---|---|---|---|---|---|---|
| 200 | OK | SuccessErrorResponse | ||||||
| ||||||||
Errors 400 · 401 · 403
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/fleet/adapters/restart" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type":"string"}'{
"success": false,
"error": "This approval is no longer pending — it was already resolved, timed out, or its agent stopped."
}Agent vitals by file path
/fleet/vitalsThe overview card of any .adf file, addressed by path as Studio's AGENT_VITALS is: a loaded agent is read from its open workspace, any other file with a readonly open, whether or not it is in a tracked folder. Same body and cache rules as GET /agents/{id}/vitals; the fleet scan behind agentsSpawned is refreshed when older than 30 s.
Query parameters
| Name | Type | Description |
|---|---|---|
pathrequired | string | Absolute path of the .adf file. |
force | string | Skip the cache: |
Responses
| Status | Description | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Vitals | AgentVitals | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
statsrequiredobject | 4 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
reachrequired | object | Reach, Access or Autonomy: a capped level on a 1-20 scale. fill = clamp(points / max, 0, 1); level = 1 + round(19 * fill), so an empty config is Lv 1 and a maxed-out one Lv 20. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
9 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
levelrequired | integer | ||||||||||||||||
pointsrequired | number | Points behind the level, after mitigations | |||||||||||||||
maxrequired | number | Points of a maxed-out config for this stat | |||||||||||||||
fillrequired | number | points / max, clamped: how much of the possible power the agent has | |||||||||||||||
openrequired | number | Points whose capability runs without approval (mitigations come off these first) | |||||||||||||||
gatedrequired | number | Points whose capability needs approval | |||||||||||||||
highrequired | boolean | True when open / max >= 0.6 (open level 12 or more): much of this runs without anyone asking | |||||||||||||||
rawPointsrequired | number | Sum of factor points, mitigations included | |||||||||||||||
factorsrequired | array<AgentStatFactor> | ||||||||||||||||
5 fields of | |||||||||||||||||
idrequired | string | Stable id, e.g. |
labelrequired | string | |
pointsrequired | number | Points this factor adds; negative for mitigations; 0 for an item past its kind's cap (7th MCP server, 4th chat adapter), listed but not counted |
gatedrequired | boolean | True when the capability needs human approval |
configPathrequired | string | Config path (or table) that controls this factor |
accessrequiredReach, Access or Autonomy: a capped level on a 1-20 scale. fill = clamp(points / max, 0, 1); level = 1 + round(19 * fill), so an empty config is Lv 1 and a maxed-out one Lv 20. max is the sum of every capped positive factor of the stat (counts such as MCP servers and chat adapters only count their heaviest few). Gated points count toward the level. points is open + gated.
autonomyrequiredReach, Access or Autonomy: a capped level on a 1-20 scale. fill = clamp(points / max, 0, 1); level = 1 + round(19 * fill), so an empty config is Lv 1 and a maxed-out one Lv 20. max is the sum of every capped positive factor of the stat (counts such as MCP servers and chat adapters only count their heaviest few). Gated points count toward the level. points is open + gated.
experiencerequiredExperience. xpForLevel(L) = 5 * (L - 1)^2.25; level = largest L with xpForLevel(L) <= score.
7 fields of experience · AgentExperienceStat
levelrequired | integer | ||||||||||||||||
progressrequired | number | Progress within the current level | |||||||||||||||
scorerequired | number | Total XP (sum of signal XP) | |||||||||||||||
levelStartrequired | number | XP at which the current level starts | |||||||||||||||
nextLevelAtrequired | number | XP at which the next level starts | |||||||||||||||
breakdownrequired | array<object> | ||||||||||||||||
4 fields of | |||||||||||||||||
idrequired | string | |
labelrequired | string | |
valuerequired | number | Raw count |
xprequired | number | XP this signal adds |
nextLevelrequiredWhat one more level takes (xp = nextLevelAt - score), in units of the cheapest signals
5 fields of nextLevel
xprequired | number | |
contextsrequired | integer | Contexts of work worth the remaining XP |
memoryTokensrequired | integer | Memory tokens worth the remaining XP |
skillsrequired | integer | Skills worth the remaining XP |
hintrequired | string |
maturityrequiredRaw maturity counts read from the agent's file.
9 fields of maturity · AgentMaturity
contextsWorkedrequired | number | Contexts of work over every loop (main, side, deleted): archived loop snapshots in adf_audit (one context at half the loop's compaction threshold or more, else its share) or live compaction summaries when loop audit is off, plus each live loop's current fill as a 0..1 share of its compaction threshold |
filesWrittenrequired | integer | adf_files rows changed after the agent was created, |
memoryTokensrequired | integer | Approximate tokens in |
localTablesrequired | integer |
|
localRowsrequired | integer | Rows across |
skillsrequired | integer | Distinct skills the agent installed or changed |
agentsSpawnedrequired | integer | null | Tracked agents whose adf_parent_did names this agent; null when no fleet scan has run |
messagesrequired | integer | Loop messages ever written, every loop current and past (adf_loop's shared AUTOINCREMENT high-water mark; compaction, clears and loop deletion do not lower it) |
ageDaysrequired | number | Days since adf_created_at |
Errors 400 · 401 · 403 · 500
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 500 | Unexpected runtime failure |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/vitals?path=PATH" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Agent activity by file path
/fleet/activityThe overview's lower sections for any .adf file, addressed by path as Studio's AGENT_ACTIVITY is. Same body and cache rules as GET /agents/{id}/activity.
Query parameters
| Name | Type | Description |
|---|---|---|
pathrequired | string | Absolute path of the .adf file. |
force | string | Skip the cache: |
Responses
| Status | Description | Body | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Activity | AgentActivity | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
dailyrequiredarray<AgentActivityDay> | 14 local days, oldest first; the last is today 5 fields of | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
daterequired | string | Local YYYY-MM-DD |
messagesrequired | integer | adf_loop rows of every role created that day, plus the day's estimated share of compacted rows archived in adf_audit |
estimated | boolean | Some of the day's messages are compacted history whose timing is estimated (spread evenly over a span ending at the archive's creation) |
costUsd | number | USD of the day's priced adf_loop rows (cost_usd in the row's usage record); absent when none had a price |
costPartial | boolean | Some calls that day had no recorded price, or were compacted (their cost is not recorded); costUsd is a lower bound |
contentsrequiredWhat the file holds, in three groups. Tokens are approximate (bytes / 4, rounded) and given for mind and skills only: table data is rarely read into context.
3 fields of contents
mindrequired | object | Files under mind/ | |||||||||||||||||||||||||||
4 fields of | |||||||||||||||||||||||||||||
filesrequired | integer | |||||||||||||
tokensrequired | integer | SUM(size) / 4, rounded, the seeded mind/log.md header taken off that file | ||||||||||||
updatedThisWeekrequired | integer | mind/ files whose updated_at is within the last 7 days | ||||||||||||
stratarequired | object | Current mind/ tokens (size / 4, rounded, the seeded mind/log.md header taken off that file) split by each file's updated_at. A boundary belongs to the younger band. | ||||||||||||
4 fields of | ||||||||||||||
olderrequired | integer | Last updated more than 90 days ago |
quarterrequired | integer | Last updated more than 30 and at most 90 days ago |
monthrequired | integer | Last updated more than 7 and at most 30 days ago |
weekrequired | integer | Last updated at most 7 days ago |
skillsrequiredSkills the agent installed or changed (the Experience stat rule)
2 fields of skills
countrequired | integer | |
tokensrequired | integer | Size of every file under those skills' directories / 4; registry entries without files add 0 |
tablesrequiredlocal_* tables (at most 50 read)
2 fields of tables
countrequired | integer | |
rowsrequired | integer | Total rows |
Errors 400 · 401 · 403 · 500
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 500 | Unexpected runtime failure |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/fleet/activity?path=PATH" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Set the state of running agents
/fleet/stateStudio's MESH_SET_AGENT_STATE: for each file, end any active turn and enter idle or hibernate. A file with no loaded agent fails with agent offline; a stopped or errored executor with agent stopped / agent error. Any other state fails every file with invalid state.
Request bodyapplication/json · FleetStateBody · required
| Field | Type | Description |
|---|---|---|
filePathsrequired | array<string> | |
staterequired | string |
Responses
| Status | Description | Body | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | FleetStateResult | |||||||||||||||
| |||||||||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/fleet/state" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filePaths":[],"state":"idle"}'Found an agent from the Mesh view
/fleet/foundStudio's MESH_FOUND_AGENT: dir must be inside a tracked folder, or with newRoot: true a sibling of a tracked root. The folder is created when missing, the file is <slug of name>.adf, made from the default template with its identity, marked reviewed, left closed, and its folder tracked. Failures answer 200 with success: false and error.
Request bodyapplication/json · FleetFoundBody · required
| Field | Type | Description |
|---|---|---|
dirrequired | string | Absolute folder for the new agent. |
namerequired | string | |
newRoot | boolean |
Responses
| Status | Description | Body | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | FleetFoundResult | |||||||||
| |||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/fleet/found" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
-H "Content-Type: application/json" \
-d '{"dir":"string","name":"string"}'