Cumulocity · Capability

Cumulocity Alarm API — Alarms

Raise, query, acknowledge, clear, and bulk-update Cumulocity alarms across CRITICAL/MAJOR/MINOR/WARNING severities.

Cumulocity Alarm API — Alarms is a Naftiko capability published by Cumulocity, one of 31 capabilities the APIs.io network indexes for this provider. It bundles 3 operations.

The capability includes 1 read-only operation and 2 state-changing operations. Lead operation: List Cumulocity alarms by source, severity, status, type, and time. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Cumulocity, Alarms, and Monitoring.

Run with Naftiko CumulocityAlarmsMonitoring

MCP Tools

cumulocity-list-alarms

List Cumulocity alarms by source, severity, status, type, and time.

read-only idempotent

cumulocity-raise-alarm

Raise a Cumulocity alarm (auto-deduplicated by source + type).

cumulocity-acknowledge-alarm

Acknowledge or clear an existing Cumulocity alarm.

idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Cumulocity Alarm API — Alarms
  description: Raise, query, acknowledge, clear, and bulk-update Cumulocity alarms across CRITICAL/MAJOR/MINOR/WARNING severities.
  tags: [Cumulocity, Alarms, Monitoring]
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    C8Y_BASE_URL: C8Y_BASE_URL
    C8Y_USER: C8Y_USER
    C8Y_PASSWORD: C8Y_PASSWORD
capability:
  consumes:
  - type: http
    namespace: alarm-alarms
    baseUri: '{{env.C8Y_BASE_URL}}'
    resources:
    - name: alarms
      path: /alarm/alarms
      operations:
      - name: listalarms
        method: GET
        description: List Alarms
        inputParameters:
        - {name: source, in: query, type: string}
        - {name: status, in: query, type: string}
        - {name: severity, in: query, type: string}
        - {name: type, in: query, type: string}
        - {name: dateFrom, in: query, type: string}
        - {name: dateTo, in: query, type: string}
        - {name: resolved, in: query, type: boolean}
      - name: createalarm
        method: POST
        description: Raise An Alarm
        inputParameters:
        - {name: body, in: body, type: object, required: true}
      - name: bulkupdatealarms
        method: PUT
        description: Bulk Update Alarms
        inputParameters:
        - {name: source, in: query, type: string}
        - {name: status, in: query, type: string}
        - {name: body, in: body, type: object, required: true}
    - name: alarm
      path: /alarm/alarms/{id}
      operations:
      - name: getalarm
        method: GET
        description: Retrieve An Alarm
        inputParameters:
        - {name: id, in: path, type: string, required: true}
      - name: updatealarm
        method: PUT
        description: Update An Alarm
        inputParameters:
        - {name: id, in: path, type: string, required: true}
        - {name: body, in: body, type: object, required: true}
    authentication:
      type: basic
      username: '{{env.C8Y_USER}}'
      password: '{{env.C8Y_PASSWORD}}'
  exposes:
  - type: mcp
    namespace: alarm-alarms-mcp
    port: 9090
    transport: http
    tools:
    - name: cumulocity-list-alarms
      description: List Cumulocity alarms by source, severity, status, type, and time.
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: alarm-alarms.listalarms
      with: {source: tools.source, status: tools.status, severity: tools.severity, type: tools.type, dateFrom: tools.dateFrom, dateTo: tools.dateTo, resolved: tools.resolved}
    - name: cumulocity-raise-alarm
      description: Raise a Cumulocity alarm (auto-deduplicated by source + type).
      hints: {readOnly: false, destructive: false, idempotent: false}
      call: alarm-alarms.createalarm
      with: {body: tools.body}
    - name: cumulocity-acknowledge-alarm
      description: Acknowledge or clear an existing Cumulocity alarm.
      hints: {readOnly: false, destructive: false, idempotent: true}
      call: alarm-alarms.updatealarm
      with: {id: tools.id, body: tools.body}