Cisco Identity Services Engine Prometheus Alertmanager API

openapi: 3.2.0
info:
  title: Cisco ISE Prometheus Alertmanager API
  version: 1.0.0
  x-provenance:
    method: harvested
    authored_by: Cisco
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    source_host: pubhub.devnetcloud.com
    note: 103 ISE API descriptions (1,490 operations; 32 OpenAPI 3.0.x + 71 Swagger 2.0) enumerated from Cisco's own DevNet project manifest and fetched anonymously. Byte-identity reconfirmed 2026-08-19 by SHA-256 against the live source.
  x-evidence:
  - type: source
    url: https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/
  - type: source
    url: https://developer.cisco.com/docs/identity-services-engine/
servers:
- url: https://10.56.60.25:443
  description: Inferred Url
tags:
- name: Prometheus Alertmanager
paths:
  /api/v1/prometheus-alertmanager/alertTrigger:
    post:
      tags:
      - Prometheus Alertmanager
      summary: Handles the incoming Cisco ISE resiliency rule triggered in Prometheus.
      description: This is a webhook registered in Prometheus for handling the rules defined for ISE resiliency.
      operationId: alertTrigger
      requestBody:
        content:
          application/json:
            schema:
              type: object
              exampleSetFlag: false
      responses:
        '200':
          description: Successful response
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - BasicAuth: []
  /api/v1/prometheus-alertmanager/receiver:
    get:
      tags:
      - Prometheus Alertmanager
      summary: Lists all the Prometheus Alertmanager receivers.
      description: Lists all the Prometheus Alertmanager receivers.
      operationId: getReceiverConfigurations
      parameters:
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Get all receivers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiversSummaryResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    post:
      tags:
      - Prometheus Alertmanager
      summary: Create a new Prometheus Alertmanager receiver configuration.
      description: Creates a new Prometheus Alertmanager configuration with the template.
      operationId: saveReceiverConfiguration
      parameters:
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReceiverConfiguration'
              exampleSetFlag: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiverConfigurationResponse'
                exampleSetFlag: false
        '201':
          description: Receiver configuration saved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiverConfigurationResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
  /api/v1/prometheus-alertmanager/receiver/{receiverId}:
    get:
      tags:
      - Prometheus Alertmanager
      summary: Get the Prometheus Alertmanager receiver configuration based on receiver ID.
      description: Get a Prometheus Alertmanager receiver configuration based on receiver ID.
      operationId: getReceiverConfigurationByID
      parameters:
      - name: receiverId
        in: path
        description: Unique name for receiver configuration. The name parameter in a receiver configuration would be its receiverId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Get recevier configuration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiverConfigurationResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    put:
      tags:
      - Prometheus Alertmanager
      summary: Updates a Prometheus Alertmanager receiver configuration.
      description: Updates an existing Prometheus Alertmanager receiver configuration.
      operationId: updateReceiverConfiguration
      parameters:
      - name: receiverId
        in: path
        description: Unique name for receiver configuration. The name parameter in a receiver configuration would be its receiverId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReceiverConfiguration'
              exampleSetFlag: false
      responses:
        '200':
          description: Receiver configuration updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiverConfigurationResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    delete:
      tags:
      - Prometheus Alertmanager
      summary: Delete the Prometheus Alertmanager receiver configuration based on receiver ID.
      description: Deletes a Prometheus Alertmanager receiver configuration based on receiver ID.
      operationId: deleteReceiverConfigurationByID
      parameters:
      - name: receiverId
        in: path
        description: Unique name for receiver configuration. The name parameter in a receiver configuration would be its receiverId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Receiver configuration deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiverConfigurationResponse'
                exampleSetFlag: false
        '204':
          description: No Content
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
  /api/v1/prometheus-alertmanager/route:
    get:
      tags:
      - Prometheus Alertmanager
      summary: Get all the Prometheus Alertmanager routes that are configured.
      description: Lists all the Prometheus Alertmanager routes that are configured.
      operationId: getRoutes
      parameters:
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Get all routes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoutesSummaryResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    post:
      tags:
      - Prometheus Alertmanager
      summary: Create a new Prometheus Alertmanager route configuration.
      description: Creates a new Prometheus Alertmanager route configuration with the template.
      operationId: saveRouteConfiguration
      parameters:
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RouteConfiguration'
              exampleSetFlag: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RouteConfigurationResponse'
                exampleSetFlag: false
        '201':
          description: Route configuration created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RouteConfigurationResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
  /api/v1/prometheus-alertmanager/route/{routeId}:
    get:
      tags:
      - Prometheus Alertmanager
      summary: Get the Prometheus Alertmanager routes configured based on route ID.
      description: Get the Prometheus Alertmanager route configuration information based on route ID.
      operationId: getRouteConfigurationByID
      parameters:
      - name: routeId
        in: path
        description: Unique name for route configuration. The alertname of the matcher parameter in a route configuration would be its routeId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Get route configuration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RouteConfigurationResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    put:
      tags:
      - Prometheus Alertmanager
      summary: Updates an existing Prometheus Alertmanager route configuration.
      description: Updates the route configuration details of an existing Prometheus Alertmanager.
      operationId: updateRouteConfiguration
      parameters:
      - name: routeId
        in: path
        description: Unique name for route configuration. The alertname of the matcher parameter in a route configuration would be its routeId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RouteConfiguration'
              exampleSetFlag: false
      responses:
        '200':
          description: Rule configuration updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RouteConfigurationResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    delete:
      tags:
      - Prometheus Alertmanager
      summary: Deletes Prometheus Alertmanager routes based on route ID.
      description: Delete an existing Prometheus Alertmanager route configuration based on the route ID.
      operationId: deleteRouteConfigurationByID
      parameters:
      - name: routeId
        in: path
        description: Unique name for route configuration. The alertname of the matcher parameter in a route configuration would be its routeId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Route configuration deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RouteConfigurationResponse'
                exampleSetFlag: false
        '204':
          description: No Content
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
  /api/v1/prometheus-alertmanager/rule:
    get:
      tags:
      - Prometheus Alertmanager
      summary: Get all Prometheus rule configurations.
      description: List all the configured Prometheus rules.
      operationId: getRulesConfigurations
      parameters:
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Get all rules.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RulesConfigurationSummaryResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    post:
      tags:
      - Prometheus Alertmanager
      summary: Create a new Prometheus rule configuration.
      description: Creates a new Prometheus rule configuration with the template.
      operationId: saveRuleConfiguration
      parameters:
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RuleConfiguration'
              exampleSetFlag: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuleConfigurationResponse'
                exampleSetFlag: false
        '201':
          description: Rule configuration created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuleConfigurationResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
  /api/v1/prometheus-alertmanager/rule/{ruleId}:
    get:
      tags:
      - Prometheus Alertmanager
      summary: Get the Prometheus rule configuration based on rule ID.
      description: Get the Prometheus rule configuration based on rule ID.
      operationId: getRuleConfigurationByID
      parameters:
      - name: ruleId
        in: path
        description: Unique name for rule configuration. The alert parameter in a rule configuration would be its ruleId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Get rule configuration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuleConfigurationResponse'
                exampleSetFlag: false
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    put:
      tags:
      - Prometheus Alertmanager
      summary: Update the Prometheus rule configuration.
      description: Updates an existing Prometheus rule configuration.
      operationId: updateRuleConfiguration
      parameters:
      - name: ruleId
        in: path
        description: Unique name for rule configuration. The alert parameter in a rule configuration would be its ruleId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RuleConfiguration'
              exampleSetFlag: false
      responses:
        '200':
          description: Rule configuration updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuleConfigurationResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
    delete:
      tags:
      - Prometheus Alertmanager
      summary: Delete a Prometheus rule configuration based on rule ID.
      description: Delete a Prometheus rule configuration based on rule ID.
      operationId: deleteRuleConfigurationByID
      parameters:
      - name: ruleId
        in: path
        description: Unique name for rule configuration. The alert parameter in a rule configuration would be its ruleId.
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      - name: X-Request-ID
        in: header
        description: The request ID header consists of the request ID which is returned in the response headers and also appears in the API service logs.
        required: false
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Rule configuration deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuleConfigurationResponse'
                exampleSetFlag: false
        '204':
          description: No Content
        '400':
          description: Bad Request for this specified resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: The specified resource was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
                exampleSetFlag: false
      security:
      - BasicAuth: []
components:
  schemas:
    RouteConfigurationResponse:
      title: RouteConfigurationResponse
      required:
      - response
      - version
      type: object
      properties:
        response:
          $ref: '#/components/schemas/RouteConfiguration'
          exampleSetFlag: true
        version:
          type: string
          exampleSetFlag: true
      exampleSetFlag: false
    RouteConfiguration:
      title: RouteConfiguration
      required:
      - matcher
      - receiver
      type: object
      properties:
        matcher:
          type: string
          description: contains alertname
          example: DummyAlert1
          exampleSetFlag: true
        receiver:
          type: string
          description: contains receiver name
          example: dummy-webhook-1
          exampleSetFlag: true
      description: Route Configuration Summary
      exampleSetFlag: false
    RuleConfigurationResponse:
      title: RuleConfigurationResponse
      required:
      - response
      - version
      type: object
      properties:
        response:
          $ref: '#/components/schemas/RuleConfiguration'
          exampleSetFlag: true
        version:
          type: string
          exampleSetFlag: true
      exampleSetFlag: false
    RoutesSummaryR

# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-ise/refs/heads/main/openapi/cisco-ise-prometheus-alertmanager-api-openapi.yml