Beta module namespace

agenttools

Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.

Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.

22 operations

Method	Path	Required permission	Authentication	Summary
get	/v1/m/agenttools/detect	system:admin	Bearer token	Discovers host executables without reading provider credential homes.
post	/v1/m/agenttools/installs	system:admin	Bearer token	Starts one audited host installation from an approved plan behind the administrative step-up.
get	/v1/m/agenttools/inventory	system:admin	Bearer token	Lists managed host tools, release integrity, verification policies and the five most recently updated installation jobs.
get	/v1/m/agenttools/jobs/{id}	system:admin	Bearer token	Returns bounded installation progress, state, errors and the verified receipt to a system administrator.
get	/v1/m/agenttools/model-servers	system:admin	Bearer token	Reports each server: installed, running or not, its endpoint and the models it serves.
post	/v1/m/agenttools/model-servers/{kind}/start	system:admin	Bearer token	Starts the installed server as a managed child of the engine and returns at once; the row reads "running" once the server answers.
post	/v1/m/agenttools/model-servers/{kind}/stop	system:admin	Bearer token	Stops the server this engine started.
get	/v1/m/agenttools/ollama	system:admin	Bearer token	Reports whether Ollama is installed, whether this engine runs it, its endpoint and the models it holds.
post	/v1/m/agenttools/ollama/pulls	system:admin	Bearer token	Downloads a model into the running Ollama and returns the download to follow; Ollama's own progress is read from it.
get	/v1/m/agenttools/ollama/pulls/{id}	system:admin	Bearer token	Reads one model download: its state and Ollama's progress.
post	/v1/m/agenttools/ollama/start	system:admin	Bearer token	Starts the installed Ollama as a managed child of the engine and returns at once; the row reads "running" once the service answers.
post	/v1/m/agenttools/ollama/stop	system:admin	Bearer token	Stops the Ollama this engine started.
get	/v1/m/agenttools/pins	system:admin	Bearer token	Lists the selected organization's stored session tool versions.
put	/v1/m/agenttools/pins	system:admin	Bearer token	Saves or clears a version selection for a tenant's workspace or agent.
post	/v1/m/agenttools/plans	system:admin	Bearer token	Resolves an official release and returns the digest-bound version, verification policy and destination for system administrator review before install.
get	/v1/m/agenttools/providers	system:admin	Bearer token	Reports one snapshot per tool instance on this node.
delete	/v1/m/agenttools/releases	system:admin	Bearer token	Deletes one verified managed host release after checking live sessions.
get	/v1/m/agenttools/sign-in	system:admin	Bearer token	Reports the tool's native login status and the active flow for this selection, so a reloaded page can continue polling the same flow.
post	/v1/m/agenttools/sign-in	system:admin	Bearer token	Starts the tool's own login on this node (claude auth login, codex or grok login --device-auth) and returns its sign-in page link, plus the device code for Codex and Grok Build.
get	/v1/m/agenttools/sign-in/{id}	system:admin	Bearer token	Reads one login in progress: its state, link and device code.
delete	/v1/m/agenttools/sign-in/{id}	system:admin	Bearer token	Stops a login in progress: the tool's login process ends on this node and the pending login is forgotten.
post	/v1/m/agenttools/sign-in/{id}/code	system:admin	Bearer token	Hands the code shown on Claude's sign-in page, or the API key a needs_key login waits for, to the waiting login and answers once the tool says whether it is signed in.