ToolHive — API
ToolHive APIv1.0 Read the vendor's spec ↗
- 77 endpoints
- 2 versions archived since Nov 11, 2026
- Last checked Nov 14, 2026
This is the ToolHive API server.
Get started
$ curl "$BASE_URL/health"
Set $BASE_URL first, then paste.
- Base URL
-
Not named in the archived spec.
$BASE_URLbelow stands for the origin you deploy against. - Authenticate
- No authentication declared in the spec
What it covers
- Workloads 15 create, read, delete
- Plugins 12 create, read, delete
- Skills 12 create, read, delete
- Registry 10 create, read, update, delete
- Clients 6 create, read, delete
- Secrets 6 create, read, update, delete
- Groups 4 create, read, delete
- Logs 2 read
- Registry Plugins 2 read
- Registry Servers 2 read
- Registry Skills 2 read
- System 2 read
Open an endpoint for a runnable command, its inputs and what it returns.
Workloads 15
-
DELETE
/api/v1beta/workloads/{name}Delete a workloadLoading…
-
GET
/api/v1beta/workloadsList all workloadsLoading…
-
GET
/api/v1beta/workloads/upgrade-checkCheck workloads for available upgradesLoading…
-
GET
/api/v1beta/workloads/{name}Get workload detailsLoading…
-
GET
/api/v1beta/workloads/{name}/exportExport workload configurationLoading…
-
GET
/api/v1beta/workloads/{name}/statusGet workload statusLoading…
-
GET
/api/v1beta/workloads/{name}/upgrade-checkCheck a workload for an available upgradeLoading…
-
POST
/api/v1beta/workloadsCreate a new workloadLoading…
-
POST
/api/v1beta/workloads/deleteDelete workloads in bulkLoading…
-
POST
/api/v1beta/workloads/restartRestart workloads in bulkLoading…
-
POST
/api/v1beta/workloads/stopStop workloads in bulkLoading…
-
POST
/api/v1beta/workloads/{name}/editUpdate workloadLoading…
-
POST
/api/v1beta/workloads/{name}/restartRestart a workloadLoading…
-
POST
/api/v1beta/workloads/{name}/stopStop a workloadLoading…
-
POST
/api/v1beta/workloads/{name}/upgradeApply an available upgrade to a workloadLoading…
Plugins 12
-
DELETE
/api/v1beta/plugins/builds/{tag}Delete a locally-built plugin artifactLoading…
-
DELETE
/api/v1beta/plugins/{name}Uninstall a pluginLoading…
-
GET
/api/v1beta/pluginsList all installed pluginsLoading…
-
GET
/api/v1beta/plugins/buildsList locally-built plugin artifactsLoading…
-
GET
/api/v1beta/plugins/contentGet plugin contentLoading…
-
GET
/api/v1beta/plugins/{name}Get plugin detailsLoading…
-
POST
/api/v1beta/pluginsInstall a pluginLoading…
-
POST
/api/v1beta/plugins/buildBuild a pluginLoading…
-
POST
/api/v1beta/plugins/pushPush a pluginLoading…
-
POST
/api/v1beta/plugins/syncSync project plugins from the lock fileLoading…
-
POST
/api/v1beta/plugins/upgradeUpgrade project pluginsLoading…
-
POST
/api/v1beta/plugins/validateValidate a pluginLoading…
Skills 12
-
DELETE
/api/v1beta/skills/builds/{tag}Delete a locally-built skill artifactLoading…
-
DELETE
/api/v1beta/skills/{name}Uninstall a skillLoading…
-
GET
/api/v1beta/skillsList all installed skillsLoading…
-
GET
/api/v1beta/skills/buildsList locally-built skill artifactsLoading…
-
GET
/api/v1beta/skills/contentGet skill contentLoading…
-
GET
/api/v1beta/skills/{name}Get skill detailsLoading…
-
POST
/api/v1beta/skillsInstall a skillLoading…
-
POST
/api/v1beta/skills/buildBuild a skillLoading…
-
POST
/api/v1beta/skills/pushPush a skillLoading…
-
POST
/api/v1beta/skills/syncSync project skills from the lock fileLoading…
-
POST
/api/v1beta/skills/upgradeUpgrade project skillsLoading…
-
POST
/api/v1beta/skills/validateValidate a skillLoading…
Registry 10
-
DELETE
/api/v1beta/registry/{name}Remove a registryLoading…
-
GET
/api/v1beta/registryList registriesLoading…
-
GET
/api/v1beta/registry/{name}Get a registryLoading…
-
GET
/api/v1beta/registry/{name}/serversList servers in a registryLoading…
-
GET
/api/v1beta/registry/{name}/servers/{serverName}Get a server from a registryLoading…
-
POST
/api/v1beta/registryAdd a registry (unavailable)Loading…
-
POST
/api/v1beta/registry/auth/loginRegistry loginLoading…
-
POST
/api/v1beta/registry/auth/logoutRegistry logoutLoading…
-
POST
/api/v1beta/registry/{name}/refreshRefresh registry cacheLoading…
-
PUT
/api/v1beta/registry/{name}Update registry configurationLoading…
Clients 6
-
DELETE
/api/v1beta/clients/{name}Unregister a clientLoading…
-
DELETE
/api/v1beta/clients/{name}/groups/{group}Unregister a client from a specific groupLoading…
-
GET
/api/v1beta/clientsList all clientsLoading…
-
POST
/api/v1beta/clientsRegister a new clientLoading…
-
POST
/api/v1beta/clients/registerRegister multiple clientsLoading…
-
POST
/api/v1beta/clients/unregisterUnregister multiple clientsLoading…
Secrets 6
-
DELETE
/api/v1beta/secrets/default/keys/{key}Delete a secretLoading…
-
GET
/api/v1beta/secrets/defaultGet secrets provider detailsLoading…
-
GET
/api/v1beta/secrets/default/keysList secretsLoading…
-
POST
/api/v1beta/secretsSetup or reconfigure secrets providerLoading…
-
POST
/api/v1beta/secrets/default/keysCreate a new secretLoading…
-
PUT
/api/v1beta/secrets/default/keys/{key}Update a secretLoading…
Groups 4
-
DELETE
/api/v1beta/groups/{name}Delete a groupLoading…
-
GET
/api/v1beta/groupsList all groupsLoading…
-
GET
/api/v1beta/groups/{name}Get group detailsLoading…
-
POST
/api/v1beta/groupsCreate a new groupLoading…
Logs 2
-
GET
/api/v1beta/workloads/{name}/logsGet logs for a specific workloadLoading…
-
GET
/api/v1beta/workloads/{name}/proxy-logsGet proxy logs for a specific workloadLoading…
Registry Plugins 2
-
GET
/registry/{registryName}/v0.1/x/dev.toolhive/pluginsList available registry pluginsLoading…
-
GET
/registry/{registryName}/v0.1/x/dev.toolhive/plugins/{namespace}/{pluginName}Get a registry pluginLoading…
Registry Servers 2
-
GET
/registry/{registryName}/v0.1/serversList available registry serversLoading…
-
GET
/registry/{registryName}/v0.1/servers/{serverName}/versions/latestGet a registry serverLoading…
Registry Skills 2
-
GET
/registry/{registryName}/v0.1/x/dev.toolhive/skillsList available registry skillsLoading…
-
GET
/registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{skillName}Get a registry skillLoading…
System 2
-
GET
/api/openapi.jsonGet OpenAPI specificationLoading…
-
GET
/healthHealth checkLoading…
Discovery 1
-
GET
/api/v1beta/discovery/clientsList all clients statusLoading…
Version 1
-
GET
/api/v1beta/versionGet server versionLoading…
No endpoint matches. Clear the filter to see all 77.