DigitalOcean API (unofficial showcase)
GET/v2/action-gateway/tools/health

List Tool Health

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.

4 parameters
providerstringoptional
Optional provider ID, matched exactly, to return only that provider's tools.
windowstringoptional
Window 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.
Allowed:HEALTH_WINDOW_ONE_HOURHEALTH_WINDOW_TWENTY_FOUR_HOURSHEALTH_WINDOW_SEVEN_DAYSHEALTH_WINDOW_THIRTY_DAYSDefault:HEALTH_WINDOW_TWENTY_FOUR_HOURS
pageintegeroptional
1-based page number. Values below 1 are treated as 1.
Default:1
per_pageintegeroptional
Page size. Defaults to 20; values above 100 are capped at 100.
Default:20

6 status codes
200The request was successful.
snapshotobjectoptional
When the metrics were computed and the window they cover.
toolsarray<object>optional
Tools sorted by provider, then tool slug.
paginationobjectoptional
Paging applied to this response and the total number of tools.
400There was an error parsing the request body.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
401Authentication failed due to invalid credentials.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
429The API rate limit has been exceeded.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
500There was a server error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
defaultThere was an unexpected error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.

Error handling

A 400 is returned: There was an error parsing the request body. A 401 is returned: Authentication failed due to invalid credentials. A 429 is returned: The API rate limit has been exceeded. A 500 is returned: There was a server error. Any other status is an error: There was an unexpected error.