List all faults

List all faults

curl --request GET \
  --url https://api.altostrat.io/faults \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "flt_31pkd1t8FvW7qZv0jG2a9kH5mB1",
      "resource_id": "dev_2j4k2l2j3k4l2j3k4",
      "customer_id": "cus_1i2j3k4l5m6n7o8p",
      "microservice_id": "wantunnel-monitor",
      "type": "wantunnel",
      "status": "unresolved",
      "severity": "CRITICAL",
      "message": "WAN link failover: Primary link (WAN1) is down",
      "cause": "Probe failed: Latency exceeded 500ms threshold",
      "created_at": "2025-10-21T12:00:00.000000Z",
      "resolved_at": null,
      "resource_ancestry_path": "site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4",
      "ttl": 1797825595,
      "comments": [
        {
          "user_id": "user_a1b2c3d4e5f6g7h8",
          "comment": "Contacted ISP, they are investigating a local outage.",
          "created_at": "2025-10-21T12:05:30.000000Z"
        }
      ]
    }
  ],
  "meta": {
    "count": 50,
    "cursor": "eyJQSyI6eyJTIjoiRkFVTFQjMzFwbGg4a2FhblB2R0h",
    "has_more": true
  }
}

GET

faults

List all faults

curl --request GET \
  --url https://api.altostrat.io/faults \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "flt_31pkd1t8FvW7qZv0jG2a9kH5mB1",
      "resource_id": "dev_2j4k2l2j3k4l2j3k4",
      "customer_id": "cus_1i2j3k4l5m6n7o8p",
      "microservice_id": "wantunnel-monitor",
      "type": "wantunnel",
      "status": "unresolved",
      "severity": "CRITICAL",
      "message": "WAN link failover: Primary link (WAN1) is down",
      "cause": "Probe failed: Latency exceeded 500ms threshold",
      "created_at": "2025-10-21T12:00:00.000000Z",
      "resolved_at": null,
      "resource_ancestry_path": "site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4",
      "ttl": 1797825595,
      "comments": [
        {
          "user_id": "user_a1b2c3d4e5f6g7h8",
          "comment": "Contacted ISP, they are investigating a local outage.",
          "created_at": "2025-10-21T12:05:30.000000Z"
        }
      ]
    }
  ],
  "meta": {
    "count": 50,
    "cursor": "eyJQSyI6eyJTIjoiRkFVTFQjMzFwbGg4a2FhblB2R0h",
    "has_more": true
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

limit

integer

default:50

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 50.

Required range: 1 <= x <= 100

cursor

string

A cursor for use in pagination. The cursor is an opaque string that specifies your current position in the list.

Example:

"eyJQSyI6eyJTIjoiRkFVTFQjMzFwbGg4a2FhblB2R0h"

from

string<date-time>

A timestamp in ISO 8601 format. Only return faults created after this time.

Example:

"2025-10-20T10:00:00Z"

string<date-time>

A timestamp in ISO 8601 format. Only return faults created before this time.

Example:

"2025-10-21T10:00:00Z"

severity

enum<string>

Filter faults by their severity level.

Available options:

LOW,

MEDIUM,

HIGH,

CRITICAL,

WARNING

type

string

Filter faults by their type, such as site or wantunnel.

Example:

"wantunnel"

resource_id

string

Filter faults to a specific resource identifier.

Example:

"dev_2j4k2l2j3k4l2j3k4"

site

string

Filter faults to a specific site and all its child resources. This performs a hierarchical query.

Example:

"site_8a7b6c5d4e3f2g1h"

status

enum<string>

Filter faults by their resolution status.

Available options:

unresolved,

resolved

Response

A paginated list of faults.

data

object[]

Show child attributes

data.id

string

A unique identifier for the fault object, prefixed with flt_.

Example:

"flt_31pkd1t8FvW7qZv0jG2a9kH5mB1"

data.resource_id

string

The unique identifier of the resource that experienced the fault.

Example:

"dev_2j4k2l2j3k4l2j3k4"

data.customer_id

string

The unique identifier of the customer account this fault belongs to.

Example:

"cus_1i2j3k4l5m6n7o8p"

data.microservice_id

string

The identifier of the microservice that reported the fault.

Example:

"wantunnel-monitor"

data.type

string

The category or type of the fault.

Example:

"wantunnel"

data.status

enum<string>

The current status of the fault.

Available options:

unresolved,

resolved

Example:

"unresolved"

data.severity

enum<string>

The severity level of the fault.

Available options:

LOW,

MEDIUM,

HIGH,

CRITICAL,

WARNING

Example:

"CRITICAL"

data.message

string

A concise, human-readable summary of the fault.

Example:

"WAN link failover: Primary link (WAN1) is down"

data.cause

string

A detailed explanation of the probable cause of the fault.

Example:

"Probe failed: Latency exceeded 500ms threshold"

data.created_at

string<date-time>

The timestamp when the fault was first detected and created.

Example:

"2025-10-21T12:00:00.000000Z"

data.resolved_at

string<date-time> | null

The timestamp when the fault was resolved. Null if the fault is still active.

Example:

null

data.resource_ancestry_path

string | null

A pipe-delimited | string representing the hierarchical location of the resource, used for filtering faults by a parent resource (e.g., a specific site).

Example:

"site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"

data.ttl

integer | null

A Unix timestamp indicating when the fault record will automatically expire from the database.

Example:

1797825595

data.comments

object[]

A list of comments associated with the fault, ordered from oldest to newest.

Show child attributes

data.comments.user_id

string

The unique identifier of the user who added the comment.

Example:

"user_a1b2c3d4e5f6g7h8"

data.comments.comment

string

The text content of the comment.

Example:

"Contacted ISP, they are investigating a local outage."

data.comments.created_at

string<date-time>

The timestamp when the comment was created.

Example:

"2025-10-21T12:05:30.000000Z"

Getting Started

Platform & Identity

Device Management & Orchestration

Automation & AI

Network Services & Connectivity

Security & Threat Management

Monitoring & Analytics

Core Services & Utilities

Authorizations

Query Parameters

Response