dots.v2.actionGateway.tools.health.get()
Generated on 5 Nov 2026
from DoTs version
v1.23.0
Usage
client.v2.actionGateway.tools.health.get(requestConfiguration?: RequestConfiguration<HealthRequestBuilderGetQueryParameters>): Promise<undefined | List_tool_health_response>Description
Returns availability and latency for each catalog tool over the requested window, sorted by provider and then tool slug. A tool with no calls in the window is listed with data_status HEALTH_DATA_STATUS_NO_DATA. Metrics are aggregated across all customers; request volumes are not reported. Tools of your team’s MCP servers are not included. Offset-paged with page and per_page.
Parameters
providerstring optionalExample:
exaOptional provider ID, matched exactly, to return only that provider's tools.
windowstring optionalWindow to aggregate over. Defaults to twenty-four hours.
-HEALTH_WINDOW_UNSPECIFIED: Twenty-four hours.
-HEALTH_WINDOW_ONE_HOUR: One hour; history points are 10 minutes.
-HEALTH_WINDOW_TWENTY_FOUR_HOURS: Twenty-four hours; history points are 1 hour.
-HEALTH_WINDOW_SEVEN_DAYS: Seven days; history points are 6 hours.
-HEALTH_WINDOW_THIRTY_DAYS: Thirty days; history points are 24 hours.pageinteger optionalExample:
11-based page number. Values below 1 are treated as 1.
perPageinteger optionalExample:
20Page size. Defaults to 20; values above 100 are capped at 100.
Request Sample
Response Example
More Information
See /v2/action-gateway/tools/health in the API reference for additional detail on responses, headers, parameters, and more.