Skip to main content
GET
/
fault
/
top_faults
Get top faulty resources
curl --request GET \
  --url https://v1.api.altostrat.io/fault/top_faults \
  --header 'Authorization: Bearer <token>'
[
  {
    "tunnel_name": "Primary link (WAN1)",
    "site_id": "site_8a7b6c5d4e3f2g1h",
    "count": 42,
    "resource_id": "dev_2j4k2l2j3k4l2j3k4",
    "faults": [
      {
        "id": "flt_31pkd1t8FvW7qZv0jG2a9kH5mB1",
        "message": "WAN link failover: Primary link (WAN1) is down",
        "resolved_at": null,
        "created_at": "2025-10-21T12:00:00.000000Z",
        "duration": "2 hours, 15 minutes",
        "severity": "error",
        "type": "wantunnel",
        "cause": "Probe failed: Latency exceeded 500ms threshold",
        "site_id": "site_8a7b6c5d4e3f2g1h",
        "resource_identifier": "dev_2j4k2l2j3k4l2j3k4"
      }
    ]
  }
]

Documentation Index

Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API requests are authenticated using a JSON Web Token (JWT) provided in the Authorization header.

Response

An array of the top faulty resources.

​
tunnel_name
string

The display name of the resource, often extracted from the fault message.

Example:

"Primary link (WAN1)"

​
site_id
string | null

The identifier of the site this resource belongs to.

Example:

"site_8a7b6c5d4e3f2g1h"

​
count
integer

The total number of faults recorded for this resource in the last 14 days.

Example:

42

​
resource_id
string

The unique identifier of the resource.

Example:

"dev_2j4k2l2j3k4l2j3k4"

​
faults
object[]

A sample of recent fault events for this resource.