Palo Alto Networks Prisma Cloud CSPM API — Alerts

naftiko: 1.0.0-alpha2
info:
  label: Palo Alto Networks Prisma Cloud CSPM API — Alerts
  description: 'Palo Alto Networks Prisma Cloud CSPM API — Alerts. 4 operations. Lead operation: Palo Alto Networks List Alerts.
    Self-contained Naftiko capability covering one Palo Alto Networks business surface.'
  tags:
  - Palo Alto Networks
  - Alerts
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PALO_ALTO_NETWORKS_API_KEY: PALO_ALTO_NETWORKS_API_KEY
capability:
  consumes:
  - type: http
    namespace: palo-alto-prisma-cloud-cspm-alerts
    baseUri: https://api.prismacloud.io
    description: Palo Alto Networks Prisma Cloud CSPM API — Alerts business capability. Self-contained, no shared references.
    resources:
    - name: alert
      path: /alert
      operations:
      - name: getalerts
        method: GET
        description: Palo Alto Networks List Alerts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: timeType
          in: query
          type: string
          description: Time filter type.
        - name: timeAmount
          in: query
          type: integer
          description: Time amount for relative time type.
        - name: timeUnit
          in: query
          type: string
          description: Time unit for relative time type.
        - name: startTime
          in: query
          type: integer
          description: Start time in epoch milliseconds for absolute time type.
        - name: endTime
          in: query
          type: integer
          description: End time in epoch milliseconds for absolute time type.
        - name: limit
          in: query
          type: integer
          description: Maximum number of alerts to return.
        - name: offset
          in: query
          type: integer
          description: Pagination offset.
        - name: severity
          in: query
          type: string
          description: Filter by alert severity.
        - name: policy.id
          in: query
          type: string
          description: Filter alerts by policy identifier.
        - name: detailed
          in: query
          type: boolean
          description: Include full alert details.
    - name: alert-dismiss
      path: /alert/dismiss
      operations:
      - name: dismissalerts
        method: POST
        description: Palo Alto Networks Dismiss Alerts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: alert-reopen
      path: /alert/reopen
      operations:
      - name: reopenalerts
        method: POST
        description: Palo Alto Networks Reopen Dismissed Alerts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: alert-id
      path: /alert/{id}
      operations:
      - name: getalert
        method: GET
        description: Palo Alto Networks Get Alert Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Unique alert identifier.
          required: true
    authentication:
      type: bearer
      token: '{{env.PALO_ALTO_NETWORKS_API_KEY}}'
  exposes:
  - type: rest
    namespace: palo-alto-prisma-cloud-cspm-alerts-rest
    port: 8080
    description: REST adapter for Palo Alto Networks Prisma Cloud CSPM API — Alerts. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/alert
      name: alert
      description: REST surface for alert.
      operations:
      - method: GET
        name: getalerts
        description: Palo Alto Networks List Alerts
        call: palo-alto-prisma-cloud-cspm-alerts.getalerts
        with:
          timeType: rest.timeType
          timeAmount: rest.timeAmount
          timeUnit: rest.timeUnit
          startTime: rest.startTime
          endTime: rest.endTime
          limit: rest.limit
          offset: rest.offset
          severity: rest.severity
          policy.id: rest.policy.id
          detailed: rest.detailed
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/alert/dismiss
      name: alert-dismiss
      description: REST surface for alert-dismiss.
      operations:
      - method: POST
        name: dismissalerts
        description: Palo Alto Networks Dismiss Alerts
        call: palo-alto-prisma-cloud-cspm-alerts.dismissalerts
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/alert/reopen
      name: alert-reopen
      description: REST surface for alert-reopen.
      operations:
      - method: POST
        name: reopenalerts
        description: Palo Alto Networks Reopen Dismissed Alerts
        call: palo-alto-prisma-cloud-cspm-alerts.reopenalerts
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/alert/{id}
      name: alert-id
      description: REST surface for alert-id.
      operations:
      - method: GET
        name: getalert
        description: Palo Alto Networks Get Alert Details
        call: palo-alto-prisma-cloud-cspm-alerts.getalert
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: palo-alto-prisma-cloud-cspm-alerts-mcp
    port: 9090
    transport: http
    description: MCP adapter for Palo Alto Networks Prisma Cloud CSPM API — Alerts. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: palo-alto-networks-list-alerts
      description: Palo Alto Networks List Alerts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: palo-alto-prisma-cloud-cspm-alerts.getalerts
      with:
        timeType: tools.timeType
        timeAmount: tools.timeAmount
        timeUnit: tools.timeUnit
        startTime: tools.startTime
        endTime: tools.endTime
        limit: tools.limit
        offset: tools.offset
        severity: tools.severity
        policy.id: tools.policy.id
        detailed: tools.detailed
      outputParameters:
      - type: object
        mapping: $.
    - name: palo-alto-networks-dismiss-alerts
      description: Palo Alto Networks Dismiss Alerts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: palo-alto-prisma-cloud-cspm-alerts.dismissalerts
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: palo-alto-networks-reopen-dismissed
      description: Palo Alto Networks Reopen Dismissed Alerts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: palo-alto-prisma-cloud-cspm-alerts.reopenalerts
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: palo-alto-networks-get-alert
      description: Palo Alto Networks Get Alert Details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: palo-alto-prisma-cloud-cspm-alerts.getalert
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.