Netdata Cloud API

openapi: 3.0.0
info:
  title: Netdata Cloud API
  description: Netdata Cloud API Documentation
  version: 0.0.1
  contact:
    name: Support
    url: https://www.netdata.cloud/support
servers:
- url: https://app.netdata.cloud
  description: Netdata Cloud
paths:
  /api/v2/spaces/{spaceID}/notifications/silencing/rrule/evaluate:
    post:
      summary: Evaluate an RRule and return occurrences
      description: 'Evaluates an RRule string and returns the next occurrences within
        the specified time window.

        This endpoint allows users to verify their rrule configuration for silencing
        rules.'
      operationId: evaluate-rrule
      tags:
      - alerts
      parameters:
      - name: spaceID
        in: path
        required: true
        description: The unique identifier of the requested space.
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/github_com_netdata_cloud-api-docs_cloud-alarm-processor-service_api.evaluateRRuleReq'
      responses:
        '200':
          description: The evaluated RRule occurrences
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_netdata_cloud-api-docs_cloud-alarm-processor-service_api.evaluateRRuleRes'
        '400':
          description: ' `\"errorCode\": \"ErrBadRequest\"`: when the request payload
            is invalid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '401':
          description: ' `\"errorCode\": \"ErrUnauthorized\"`: when the provided user
            token/cookie cannot be matched with an account'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '403':
          description: ' `\"errorCode\": \"ErrForbidden\"`: when caller has no permissions
            to access the space or evaluate silencing rrules'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '413':
          description: ' `\"errorCode\": \"ErrRequestEntityTooLarge\"`: when the rrule
            evaluation exceeds the allowed processing time, indicating a too wide
            time window'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '422':
          description: ' `\"errorCode\": \"ErrUnprocessableEntity\"`: when invalid
            spaceID is provided'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '500':
          description: ' `\"errorCode\": \"ErrInternal\"`: when some Internal Server
            Error has occurred'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
  /api/v2/spaces/{spaceID}/notifications/silencing/rule:
    post:
      summary: Create a new Alert Notification Silencing Rule
      description: Creates an Alert Notification Silencing Rule according to the specifications
        provided
      operationId: create-silencing-rule
      tags:
      - alerts
      parameters:
      - name: spaceID
        in: path
        required: true
        description: The unique identifier of the requested space.
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/github_com_netdata_cloud-api-docs_cloud-alarm-processor-service_api.silencingRule'
      responses:
        '200':
          description: The newly created Silencing Rule
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_netdata_cloud-api-docs_cloud-alarm-processor-service_api.silencingRule'
        '400':
          description: ' `"errorCode": "ErrBadRequest"`: when the Silencing Rule request
            payload is invalid. Per-field validation errors are returned'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '401':
          description: ' `"errorCode": "ErrUnauthorized"`: when the provided user
            token/cookie cannot be matched with an account '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '403':
          description: ' `"errorCode": "ErrForbidden"`: when caller is not authorized
            to access the space or create an Alert Notification Silencing Rule'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '422':
          description: ' `"errorCode": "ErrUnprocessableEntity"`: when invalid spaceID
            is provided. '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '500':
          description: ' `"errorCode": "ErrInternal"`: when some Internal Server Error
            has occurred '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
  /api/v2/spaces/{spaceID}/notifications/silencing/rule/ruleID:
    put:
      summary: Update an existing Alert Notification Silencing Rule
      description: Updates an existing Alert Notification Silencing Rule according
        to the specifications provided
      operationId: update-silencing-rule
      tags:
      - alerts
      parameters:
      - name: spaceID
        in: path
        required: true
        description: The unique identifier of the requested space.
        schema:
          type: string
          format: uuid
      - name: ruleID
        in: path
        required: true
        description: The unique identifier of the Silencing Rule to be updated.
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/github_com_netdata_cloud-api-docs_cloud-alarm-processor-service_api.silencingRule'
      responses:
        '200':
          description: The newly updated Silencing Rule
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_netdata_cloud-api-docs_cloud-alarm-processor-service_api.silencingRule'
        '400':
          description: ' `"errorCode": "ErrBadRequest"`: when the Silencing Rule ID
            or request payload is invalid. Per-field validation errors are returned
            in case of invalid Silencing Rule definition'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '401':
          description: ' `"errorCode": "ErrUnauthorized"`: when the provided user
            token/cookie cannot be matched with an account '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '403':
          description: ' `"errorCode": "ErrForbidden"`: when caller is not authorized
            to access the space or update an Alert Notification Silencing Rule'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '404':
          description: ' `"errorCode": "ErrNotFound"`: when the Silencing Rule to
            be updated was not found'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '422':
          description: ' `"errorCode": "ErrUnprocessableEntity"`: when invalid spaceID
            is provided. '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '500':
          description: ' `"errorCode": "ErrInternal"`: when some Internal Server Error
            has occurred '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
  /api/v2/spaces/{spaceID}/notifications/silencing/rules:
    get:
      summary: Get all the Alert Notification Silencing Rules
      description: Retrieve the Alert Notification Silencing Rules of a given space
      operationId: get-silencing-rules
      tags:
      - alerts
      parameters:
      - name: spaceID
        in: path
        required: true
        description: The unique identifier of the requested space.
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: The available Silencing Rules
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/github_com_netdata_cloud-api-docs_cloud-alarm-processor-service_api.silencingRule'
        '401':
          description: ' `"errorCode": "ErrUnauthorized"`: when the provided user
            token/cookie cannot be matched with an account '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '403':
          description: ' `"errorCode": "ErrForbidden"`: when caller is not authorized
            to access the space or retrieve Alert Notification Silencing Rules'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '422':
          description: ' `"errorCode": "ErrUnprocessableEntity"`: when invalid spaceID
            is provided. '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '500':
          description: ' `"errorCode": "ErrInternal"`: when some Internal Server Error
            has occurred '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
  /api/v2/spaces/{spaceID}/notifications/silencing/rules/delete:
    post:
      summary: Delete Alert Notification Silencing Rules
      description: Deletes the targeted Alert Notification Silencing Rules of a given
        space
      operationId: delete-silencing-rules
      tags:
      - alerts
      parameters:
      - name: spaceID
        in: path
        required: true
        description: The unique identifier of the requested space.
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
      responses:
        '200':
          description: OK
        '400':
          description: ' `"errorCode": "ErrBadRequest"`: at least one of the Silencing
            Rule IDs in the request payload is invalid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '401':
          description: ' `"errorCode": "ErrUnauthorized"`: when the provided user
            token/cookie cannot be matched with an account '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '403':
          description: ' `"errorCode": "ErrForbidden"`: when caller is not authorized
            to access the space or delete Alert Notification Silencing Rules'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '422':
          description: ' `"errorCode": "ErrUnprocessableEntity"`: when invalid spaceID
            is provided. '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '500':
          description: ' `"errorCode": "ErrInternal"`: when some Internal Server Error
            has occurred '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
  /api/v2/spaces/{spaceID}/rooms/{roomID}/alerts:misconfigured:
    post:
      summary: Get misconfigured alerts for a room
      description: Retrieve alerts that are firing too often, stuck in a raised state,
        silenced for too long, or never dispatched for a given room
      operationId: get-room-alerts-misconfigured
      tags:
      - alerts
      parameters:
      - name: spaceID
        in: path
        required: true
        description: The unique identifier of the space.
        schema:
          type: string
          format: uuid
      - name: roomID
        in: path
        required: true
        description: The unique identifier of the room.
        schema:
          type: string
          format: uuid
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.misconfiguredAlertsRequest'
      responses:
        '200':
          description: The misconfigured alerts results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.misconfiguredAlertsResponse'
        '400':
          description: ' `\"errorCode\": \"ErrBadRequest\"`: when the request payload
            is invalid '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '401':
          description: ' `\"errorCode\": \"ErrUnauthorized\"`: when the provided user
            token/cookie cannot be matched with an account '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '403':
          description: ' `\"errorCode\": \"ErrForbidden\"`: when caller is not authorized
            to access the space or room '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '422':
          description: ' `\"errorCode\": \"ErrUnprocessableEntity\"`: when invalid
            spaceID or roomID is provided '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '500':
          description: ' `\"errorCode\": \"ErrInternal\"`: when some Internal Server
            Error has occurred '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
  /api/v3/spaces/{spaceID}/rooms/{roomID}/data:
    post:
      summary: Time series data queries
      description: Multi-node, multi-context, multi-instance, multi-dimension data
        queries, with time and metric aggregation.
      operationId: post-scope-data
      tags:
      - charts
      parameters:
      - name: spaceID
        in: path
        required: true
        description: The unique identifier of the requested space.
        schema:
          type: string
          format: uuid
      - name: roomID
        in: path
        required: true
        description: The unique identifier of the requested room.
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/github_com_netdata_cloud-charts-service_internal_model.ScopeDataRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_netdata_cloud-charts-service_internal_model.ScopeDataResponse'
        '400':
          description: ' `"errorCode": "ErrBadRequest"`: when invalid query parameters/req.
            payload are provided <br /> `"errorCode": "ErrBigAgentResponses"`: when
            Agents return big responses and the caller needs to filter further, reduce
            the amount of requested `points` or use parents <br /> `"errorCode": "ErrNoEligibleNodeRequested"`:
            when no eligible nodes were targeted due to space plan restrictions <br
            /> `"errorCode": "ErrAllNodesFailed"`: when all Agent requests failed,
            details on every failure are included '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '401':
          description: ' `"errorCode": "ErrUnauthorized"`: when the caller is not
            authenticated or not authorized to access this resource '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
        '500':
          description: ' `"errorCode": "ErrInternal"`: when some Internal Server Error
            has occurred '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
components:
  schemas:
    errors.Error:
      type: object
      properties:
        details:
          type: object
          additionalProperties: {}
        errorCode:
          type: string
        errorMessage:
          type: string
        errorMsgKey:
          type: string
        validationErrors:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/errors.ValidationError'
    errors.ValidationError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
    github_com_netdata_cloud-alarm-processor-service_api.MisconfiguredNode:
      type: object
      properties:
        id:
          description: Node unique identifier
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        name:
          description: Node hostname
          type: string
          example: ip-172-31-0-1
    github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneAlert:
      type: object
      properties:
        chart:
          description: Chart the alert belongs to
          type: string
          example: disk_space._
        context:
          description: Chart context
          type: string
          example: disk.space
        name:
          description: Alert name
          type: string
          example: disk_space_usage
    github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneItem:
      type: object
      properties:
        alert:
          description: Alert identity
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneAlert'
        count:
          description: Number of dispatch events where no notification was sent within
            the lookback window
          type: integer
          example: 42
        first:
          description: Timestamp of the first non-dispatched event, in unix milliseconds
          type: integer
          example: 1710892800000
        last:
          description: Timestamp of the last non-dispatched event, in unix milliseconds
          type: integer
          example: 1711497600000
        node:
          description: Node where this alert is not dispatched
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.MisconfiguredNode'
    github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneResponse:
      type: object
      properties:
        items:
          description: Individual alerts that exceeded the non-dispatched event threshold
          type: array
          items:
            $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneItem'
        totals:
          description: Aggregated counts across all dispatch-none items
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneTotals'
    github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneThresholds:
      type: object
      properties:
        count:
          description: Minimum non-dispatched event count to flag an alert (default
            10, max 5000)
          type: integer
          example: 10
        window_seconds:
          description: Lookback window in seconds for dispatch-none detection (default
            2592000, max 7776000)
          type: integer
          example: 2592000
    github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneTotals:
      type: object
      properties:
        count:
          description: Sum of non-dispatched event counts across all flagged alerts
          type: integer
          example: 150
        items:
          description: Number of alerts flagged as never dispatched
          type: integer
          example: 3
    github_com_netdata_cloud-alarm-processor-service_api.evaluateRRuleReq:
      type: object
      properties:
        lasts_until:
          description: The end time for the daily active window (optional)
          type: string
          example: '2025-05-20T01:49:01.803Z'
        limit:
          description: 'Maximum number of occurrences to return (optional, default:
            10, max: 100)'
          type: integer
          example: 10
        rrule:
          description: The RRule string to evaluate (RFC 5545 format)
          type: string
          example: RRULE:FREQ=DAILY
        starts_at:
          description: The start time for the rrule (DTSTART)
          type: string
          example: '2025-05-19T13:49:01.803Z'
        timezone:
          description: 'IANA timezone the recurrence is anchored to (optional, default:
            UTC). The

            rrule fires at the intended wall-clock time in this zone across DST transitions'
          type: string
          example: America/New_York
        window:
          description: The evaluation time window
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.evaluateRRuleWindowReq'
    github_com_netdata_cloud-alarm-processor-service_api.evaluateRRuleRes:
      type: object
      properties:
        has_more:
          description: Whether there are more occurrences beyond the limit
          type: boolean
          example: false
        occurrences:
          description: List of occurrence timestamps within the window
          type: array
          items:
            $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.occurrence'
        rrule:
          description: The normalized rrule string
          type: string
          example: 'DTSTART:20250519T134901Z

            RRULE:FREQ=DAILY'
    github_com_netdata_cloud-alarm-processor-service_api.evaluateRRuleWindowReq:
      type: object
      properties:
        end:
          description: End of the evaluation time window
          type: string
          example: '2025-06-19T00:00:00Z'
        start:
          description: Start of the evaluation time window
          type: string
          example: '2025-05-19T00:00:00Z'
    github_com_netdata_cloud-alarm-processor-service_api.firingOftenAlert:
      type: object
      properties:
        chart:
          description: Chart the alert belongs to
          type: string
          example: system.cpu
        context:
          description: Chart context
          type: string
          example: system.cpu
        name:
          description: Alert name
          type: string
          example: 10min_cpu_usage
    github_com_netdata_cloud-alarm-processor-service_api.firingOftenItem:
      type: object
      properties:
        alert:
          description: Alert identity
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.firingOftenAlert'
        node:
          description: Node where this alert fires
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.MisconfiguredNode'
        transitions:
          description: Number of transitions within the lookback window
          type: integer
          example: 100
    github_com_netdata_cloud-alarm-processor-service_api.firingOftenResponse:
      type: object
      properties:
        items:
          description: Individual alerts that exceeded the transition threshold
          type: array
          items:
            $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.firingOftenItem'
        totals:
          description: Aggregated counts across all firing-often items
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.firingOftenTotals'
    github_com_netdata_cloud-alarm-processor-service_api.firingOftenThresholds:
      type: object
      properties:
        transitions:
          description: Minimum number of transitions to flag an alert (default 30,
            max 5000)
          type: integer
          example: 30
        window_seconds:
          description: Lookback window in seconds for counting transitions (default
            259200, max 7776000)
          type: integer
          example: 259200
    github_com_netdata_cloud-alarm-processor-service_api.firingOftenTotals:
      type: object
      properties:
        items:
          description: Number of alerts flagged as firing too often
          type: integer
          example: 5
        transitions:
          description: Sum of transitions across all flagged alerts
          type: integer
          example: 420
    github_com_netdata_cloud-alarm-processor-service_api.misconfiguredAlertsRequest:
      type: object
      properties:
        categories:
          description: Filter results to specific misconfiguration categories; empty
            means all categories
          type: array
          items:
            type: string
            enum:
            - firing_often
            - stuck_raised
            - silenced_long
            - dispatch_none
          example:
          - firing_often
          - stuck_raised
          - silenced_long
          - dispatch_none
        thresholds:
          description: Override default detection thresholds per category
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.misconfiguredAlertsThresholds'
    github_com_netdata_cloud-alarm-processor-service_api.misconfiguredAlertsResponse:
      type: object
      properties:
        dispatch_none:
          description: Results for alerts where no notification was dispatched; nil
            when category is excluded
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneResponse'
        firing_often:
          description: Results for alerts transitioning too frequently; nil when category
            is excluded
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.firingOftenResponse'
        silenced_long:
          description: Results for alerts silenced for too long; nil when category
            is excluded
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.silencedLongResponse'
        stuck_raised:
          description: Results for alerts stuck in a raised state; nil when category
            is excluded
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.stuckRaisedResponse'
        thresholds:
          description: Thresholds used for the calculation; always present
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.misconfiguredAlertsThresholds'
    github_com_netdata_cloud-alarm-processor-service_api.misconfiguredAlertsThresholds:
      type: object
      properties:
        dispatch_none:
          description: Thresholds for the dispatch-none category
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.dispatchNoneThresholds'
        firing_often:
          description: Thresholds for the firing-often category
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.firingOftenThresholds'
        silenced_long:
          description: Thresholds for the silenced-long category
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.silencedLongThresholds'
        stuck_raised:
          description: Thresholds for the stuck-raised category
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.stuckRaisedThresholds'
    github_com_netdata_cloud-alarm-processor-service_api.occurrence:
      type: object
      properties:
        end:
          description: The end time of the occurrence (only present if lasts_until
            was provided)
          type: string
          example: '2025-05-20T01:49:01.803Z'
        start:
          description: The start time of the occurrence
          type: string
          example: '2025-05-19T13:49:01.803Z'
    github_com_netdata_cloud-alarm-processor-service_api.silencedLongAlert:
      type: object
      properties:
        chart:
          description: Chart the alert belongs to
          type: string
          example: disk_space._
        context:
          description: Chart context
          type: string
          example: disk.space
        name:
          description: Alert name
          type: string
          example: disk_space_usage
    github_com_netdata_cloud-alarm-processor-service_api.silencedLongItem:
      type: object
      properties:
        alert:
          description: Alert identity
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.silencedLongAlert'
        count:
          description: Number of dispatch events where the alert was silenced within
            the lookback window
          type: integer
          example: 72
        first_silenced:
          description: Timestamp of the first silenced dispatch event, in unix milliseconds
          type: integer
          example: 1710892800000
        last_silenced:
          description: Timestamp of the last silenced dispatch event, in unix milliseconds
          type: integer
          example: 1711497600000
        node:
          description: Node where this alert is silenced
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.MisconfiguredNode'
    github_com_netdata_cloud-alarm-processor-service_api.silencedLongResponse:
      type: object
      properties:
        items:
          description: Individual alerts that exceeded the silenced dispatch threshold
          type: array
          items:
            $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.silencedLongItem'
        totals:
          description: Aggregated counts across all silenced-long items
          allOf:
          - $ref: '#/components/schemas/github_com_netdata_cloud-alarm-processor-service_api.silencedLongTotals'
    github_com_netdata_cloud-alarm-processor-service_api.silencedLongThresholds:
      type: object
      properties:
        count:
          description: Minimum silenced dispatch count to flag an alert (default 20,
            max 5000)
          type: integer
          example: 20
        window_seconds:
          description: Lookback window in seconds for silenced-long detection (default
            2592000, max 7776000)
          type: integer
          example: 2592000
    github_com_netdata_cloud-alarm-processor-service_api.silencedLongTotals:
      type: object
      properties:
        count:
          description: Sum of silenced dispatch counts across all flagged alerts
          type: int

# --- truncated at 32 KB (101 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/openapi/netdata-cloud-api-openapi.yml