Skip to main content
POST
Reload one app tool from its stored definition

Authorizations

x-api-key
string
header
required

Body

application/json

Re-register or remove one app tool by kind and name, optionally restricting the fleet fan-out to specific targets.

kind
string
required

The tool kind (e.g. "example_tool").

Minimum string length: 1
name
string
required

The tool name.

Minimum string length: 1
targets
string[] | null

Workers to restrict the fan-out to.

Response

Success.

data
FleetResult · object
required

The awaited result of one :meth:WorkerBus.publish.

Two honest shapes. Reachable (reachable=True): results holds, per worker, the expected workers' verdicts (the synthesized self entry included) AND the gap rows (resyncing / recycling / stale) for rows that failed the ready+ fresh gate — each carried as its actual condition rather than dropped. Bus-unreachable (reachable=False): the transport failed before any worker could reply, so there is NO worker list — only error. local_only marks the result of the no-op :meth:WorkerBus.local variant.