Graphiant

Graphiant Troubleshooting API

The Troubleshooting API from Graphiant — 6 operation(s) for troubleshooting.

GitHub OpenAPI
Business capability
Network Fault Management BC-2600.10

Operations 6

GET /v1/troubleshooting/site-connectivity-status Get troubleshooting site connectivity status #
POST /v1/troubleshooting/device/{deviceId} Create troubleshooting device by device id #
POST /v1/troubleshooting/enterprise Create troubleshooting enterprise #
GET /v1/troubleshooting/filter Get troubleshooting filter #
GET /v1/troubleshooting/site/{siteId} Get troubleshooting site by site id #
POST /v1/troubleshooting/top-sites-by-alerts Create troubleshooting top sites by alerts #

Documentation

📖
Documentation
https://docs.graphiant.com/docs/graphiant-portal-rest-api
📖
APIReference
https://docs.graphiant.com/apidocs
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/authentication/graphiant-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/openapi/graphiant-troubleshooting-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/json-schema/graphiant-v1-troubleshooting-device-device-id-post-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/json-schema/graphiant-v1-troubleshooting-filter-get-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/json-schema/graphiant-v1-troubleshooting-top-sites-by-alerts-post-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/json-schema/graphiant-v1-troubleshooting-site-site-id-get-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/json-schema/graphiant-v1-troubleshooting-enterprise-post-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/json-schema/graphiant-v1-troubleshooting-site-connectivity-status-get-response-schema.json

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/errors/graphiant-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/conventions/graphiant-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/data-model/graphiant-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/graphiant:graphiant-troubleshooting-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

graphiant-troubleshooting-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Graphiant Troubleshooting API
  version: 1.0.0
  description: Graphiant API documentation.
servers:
- url: https://api.graphiant.com
security:
- jwtAuth: []
tags:
- name: Troubleshooting
paths:
  /v1/troubleshooting/site-connectivity-status:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1TroubleshootingSiteConnectivityStatusGetResponse'
      tags:
      - Troubleshooting
      summary: Get troubleshooting site connectivity status
      x-summary-source: derived
      operationId: getV1TroubleshootingSiteConnectivityStatus
      x-operation-id-source: derived
  /v1/troubleshooting/device/{deviceId}:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1TroubleshootingDeviceDeviceIdPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1TroubleshootingDeviceDeviceIdPostResponse'
      tags:
      - Troubleshooting
      summary: Create troubleshooting device by device id
      x-summary-source: derived
      operationId: postV1TroubleshootingDeviceByDeviceId
      x-operation-id-source: derived
  /v1/troubleshooting/enterprise:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1TroubleshootingEnterprisePostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1TroubleshootingEnterprisePostResponse'
      tags:
      - Troubleshooting
      summary: Create troubleshooting enterprise
      x-summary-source: derived
      operationId: postV1TroubleshootingEnterprise
      x-operation-id-source: derived
  /v1/troubleshooting/filter:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1TroubleshootingFilterGetResponse'
      tags:
      - Troubleshooting
      summary: Get troubleshooting filter
      x-summary-source: derived
      operationId: getV1TroubleshootingFilter
      x-operation-id-source: derived
  /v1/troubleshooting/site/{siteId}:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: siteId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1TroubleshootingSiteSiteIdGetResponse'
      tags:
      - Troubleshooting
      summary: Get troubleshooting site by site id
      x-summary-source: derived
      operationId: getV1TroubleshootingSiteBySiteId
      x-operation-id-source: derived
  /v1/troubleshooting/top-sites-by-alerts:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1TroubleshootingTopSitesByAlertsPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1TroubleshootingTopSitesByAlertsPostResponse'
      tags:
      - Troubleshooting
      summary: Create troubleshooting top sites by alerts
      x-summary-source: derived
      operationId: postV1TroubleshootingTopSitesByAlerts
      x-operation-id-source: derived
components:
  schemas:
    v1TroubleshootingEnterprisePostResponse:
      type: object
      properties:
        sites:
          type: array
          items:
            $ref: '#/components/schemas/v1TroubleshootingEnterprisePostResponseSiteSummary'
      additionalProperties: false
    statsmonTroubleshootingLastCrash:
      type: object
      properties:
        crashDetails:
          type: string
          example: example string
        reason:
          type: string
          example: example string
        upSinceTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
      additionalProperties: false
    v1TroubleshootingDeviceDeviceIdPostResponse:
      type: object
      properties:
        MaintenanceMode:
          type: boolean
          example: true
        colrActive:
          type: boolean
          example: true
        controlPlane:
          $ref: '#/components/schemas/statsmonTroubleshootingControlPlane'
        dataPlane:
          $ref: '#/components/schemas/statsmonTroubleshootingDataPlane'
        issues:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingIssue'
        lifecycleStatus:
          type: string
          example: ENUM_VALUE
        status:
          type: string
          example: ENUM_VALUE
        swVersion:
          type: string
          example: example string
        swVersionV2:
          $ref: '#/components/schemas/upgradeSwVersion'
        systemPlane:
          $ref: '#/components/schemas/statsmonTroubleshootingSystemPlane'
        upSinceTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
      additionalProperties: false
    v1TroubleshootingEnterprisePostRequest:
      type: object
      properties:
        dimensions:
          $ref: '#/components/schemas/v1TroubleshootingEnterprisePostRequestDimensions'
        filter:
          $ref: '#/components/schemas/statsmonTroubleshootingFilter'
      additionalProperties: false
    statsmonTroubleshootingDataPlane:
      type: object
      properties:
        downTransitions:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingTransitions'
        sessionSlas:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSessionSla'
        status:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    v1TroubleshootingTopSitesByAlertsPostResponseSiteCounts:
      type: object
      properties:
        siteCounts:
          type: array
          items:
            $ref: '#/components/schemas/v1TroubleshootingTopSitesByAlertsPostResponseSiteCountsSiteCount'
      additionalProperties: false
    statsmonTroubleshootingSessionSla:
      type: object
      properties:
        name:
          type: string
          example: example string
        values:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSlaValue'
      additionalProperties: false
    v1TroubleshootingSiteConnectivityStatusGetResponseSiteStatus:
      type: object
      properties:
        siteId:
          type: integer
          format: int64
          example: 1234567891011
        status:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    statsmonTroubleshootingMaintenanceWindow:
      type: object
      properties:
        timeWindow:
          $ref: '#/components/schemas/statsmonTroubleshootingTimeWindow'
      additionalProperties: false
    statsmonTroubleshootingRegionFilter:
      type: object
      properties:
        region:
          $ref: '#/components/schemas/statsmonTroubleshootingRegion'
      additionalProperties: false
    statsmonTroubleshootingFilter:
      type: object
      properties:
        circuitNames:
          type: array
          items:
            type: string
            example: example string
        deviceIds:
          type: array
          items:
            type: integer
            format: int64
            example: 1234567891011
        lanSegments:
          type: array
          items:
            type: string
            example: example string
        regionIds:
          type: array
          items:
            type: integer
            format: int64
            example: 1234567891011
        siteIds:
          type: array
          items:
            type: integer
            format: int64
            example: 1234567891011
      additionalProperties: false
    statsmonTroubleshootingDeviceFilter:
      type: object
      properties:
        deviceId:
          type: integer
          format: int64
          example: 1234567891011
        deviceName:
          type: string
          example: example string
      additionalProperties: false
    v1TroubleshootingEnterprisePostRequestDimensions:
      type: object
      properties:
        certificateExpiry:
          type: boolean
          example: true
        coreConnectivity:
          type: boolean
          example: true
        coreTransitions:
          type: boolean
          example: true
        cpu:
          type: boolean
          example: true
        crashes:
          type: boolean
          example: true
        creditExpiry:
          type: boolean
          example: true
        disk:
          type: boolean
          example: true
        fanSpeed:
          type: boolean
          example: true
        licenseExpiry:
          type: boolean
          example: true
        memory:
          type: boolean
          example: true
        odpConnectivity:
          type: boolean
          example: true
        odpTransitions:
          type: boolean
          example: true
        slaPerformance:
          type: boolean
          example: true
        t2Connectivity:
          type: boolean
          example: true
        t2Transitions:
          type: boolean
          example: true
        temperature:
          type: boolean
          example: true
      additionalProperties: false
    statsmonTroubleshootingSlaValue:
      type: object
      properties:
        delayValue:
          type: number
          format: double
          example: 123.45
        jitterValue:
          type: number
          format: double
          example: 123.45
        lossValue:
          type: number
          format: double
          example: 123.45
        status:
          type: string
          example: ENUM_VALUE
        time:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        value:
          type: number
          format: double
          example: 123.45
      additionalProperties: false
    statsmonTroubleshootingControlPlane:
      type: object
      properties:
        controlTransitions:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingTransitions'
        managementTransitions:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingTransitions'
        status:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    statsmonTroubleshootingSiteFilter:
      type: object
      properties:
        siteId:
          type: integer
          format: int64
          example: 1234567891011
        siteName:
          type: string
          example: example string
      additionalProperties: false
    upgradeSwVersion:
      type: object
      properties:
        name:
          type: string
          example: example string
        release:
          type: string
          example: ENUM_VALUE
        version:
          type: string
          example: example string
      additionalProperties: false
    statsmonTroubleshootingSystemStat:
      type: object
      properties:
        interfaceName:
          type: string
          example: example string
        peerName:
          type: string
          example: example string
        time:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        value:
          type: number
          format: double
          example: 123.45
      additionalProperties: false
    statsmonTroubleshootingOverheating:
      type: object
      properties:
        timeWindow:
          $ref: '#/components/schemas/statsmonTroubleshootingTimeWindow'
      additionalProperties: false
    statsmonTroubleshootingCrash:
      type: object
      properties:
        time:
          $ref: '#/components/schemas/googleProtobufTimestamp'
      additionalProperties: false
    statsmonTroubleshootingSystemPlane:
      type: object
      properties:
        cpu:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSystemStat'
        crashes:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingCrash'
        disk:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSystemStat'
        lastCrash:
          $ref: '#/components/schemas/statsmonTroubleshootingLastCrash'
        maintenanceWindows:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingMaintenanceWindow'
        memory:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSystemStat'
        status:
          type: string
          example: ENUM_VALUE
        temperature:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingOverheating'
        temperatureSeries:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSystemStat'
      additionalProperties: false
    v1TroubleshootingTopSitesByAlertsPostRequest:
      type: object
      properties:
        filter:
          $ref: '#/components/schemas/statsmonTroubleshootingFilter'
      additionalProperties: false
    statsmonTroubleshootingRegion:
      type: object
      properties:
        regionId:
          type: integer
          format: int32
          example: 123
        regionName:
          type: string
          example: example string
      additionalProperties: false
    v1TroubleshootingSiteConnectivityStatusGetResponse:
      type: object
      properties:
        connectivityStatus:
          type: array
          items:
            $ref: '#/components/schemas/v1TroubleshootingSiteConnectivityStatusGetResponseSiteStatus'
      additionalProperties: false
    v1TroubleshootingEnterprisePostResponseSiteSummary:
      type: object
      properties:
        controlStatus:
          type: string
          example: ENUM_VALUE
        dataStatus:
          type: string
          example: ENUM_VALUE
        overallStatus:
          type: string
          example: ENUM_VALUE
        region:
          $ref: '#/components/schemas/statsmonTroubleshootingRegion'
        selectedStatus:
          type: string
          example: ENUM_VALUE
        siteId:
          type: integer
          format: int64
          example: 1234567891011
        siteName:
          type: string
          example: example string
        systemStatus:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    v1TroubleshootingSiteSiteIdGetResponse:
      type: object
      properties:
        edgeStatuses:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingEdgeStatus'
        siteName:
          type: string
          example: example string
        siteStatus:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    statsmonTroubleshootingEdgeStatus:
      type: object
      properties:
        deviceId:
          type: integer
          format: int64
          example: 1234567891011
        deviceName:
          type: string
          example: example string
        deviceStatus:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    statsmonTroubleshootingTransitions:
      type: object
      properties:
        name:
          type: string
          example: example string
        transitions:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSystemStat'
      additionalProperties: false
    statsmonTroubleshootingLanSegmentFilter:
      type: object
      properties:
        lanSegment:
          type: string
          example: example string
      additionalProperties: false
    statsmonTroubleshootingTimeWindow:
      type: object
      properties:
        bucketSizeSec:
          type: integer
          format: int32
          example: 123
          minimum: 0
        oldTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        recentTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
      additionalProperties: false
    v1TroubleshootingTopSitesByAlertsPostResponse:
      type: object
      properties:
        controlPlane:
          $ref: '#/components/schemas/v1TroubleshootingTopSitesByAlertsPostResponseSiteCounts'
        dataPlane:
          $ref: '#/components/schemas/v1TroubleshootingTopSitesByAlertsPostResponseSiteCounts'
        systemPlane:
          $ref: '#/components/schemas/v1TroubleshootingTopSitesByAlertsPostResponseSiteCounts'
      additionalProperties: false
    v1TroubleshootingTopSitesByAlertsPostResponseSiteCountsSiteCount:
      type: object
      properties:
        numAlerts:
          type: integer
          format: int32
          example: 123
        siteName:
          type: string
          example: example string
      additionalProperties: false
    statsmonTroubleshootingIssue:
      type: object
      properties:
        alertId:
          type: string
          example: example string
        allowListed:
          type: boolean
          example: true
        component:
          type: string
          example: example string
        endTime:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        entity:
          type: string
          example: example string
        issue:
          type: string
          example: example string
        muteListed:
          type: boolean
          example: true
        notificationCreated:
          type: boolean
          example: true
        plane:
          type: string
          example: example string
        reason:
          type: string
          example: example string
        severity:
          type: string
          example: ENUM_VALUE
        startTime:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        status:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    googleProtobufTimestamp:
      type: object
      properties:
        nanos:
          type: integer
          format: int32
          example: 123
        seconds:
          type: integer
          format: int64
          example: 1234567891011
      additionalProperties: false
    statsmonTroubleshootingCircuitFilter:
      type: object
      properties:
        circuitName:
          type: string
          example: example string
      additionalProperties: false
    v1TroubleshootingFilterGetResponse:
      type: object
      properties:
        circuits:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingCircuitFilter'
        devices:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingDeviceFilter'
        lanSegments:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingLanSegmentFilter'
        regions:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingRegionFilter'
        sites:
          type: array
          items:
            $ref: '#/components/schemas/statsmonTroubleshootingSiteFilter'
      additionalProperties: false
    v1TroubleshootingDeviceDeviceIdPostRequest:
      type: object
      properties:
        timeWindow:
          $ref: '#/components/schemas/statsmonTroubleshootingTimeWindow'
      additionalProperties: false
  securitySchemes:
    jwtAuth:
      type: apiKey
      in: header
      name: authorization
      description: Use `Bearer <token>`