Cisco Identity Services Engine Failure Reasons API

openapi: 3.2.0
info:
  title: MnT Failure Reasons API
  version: 1.0.0
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  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://{server}/admin/API/mnt
  variables:
    server:
      default: localhost
      description: The host where the API is rooted
security:
- basicAuth: []
tags:
- name: FailureReasons
paths:
  /FailureReasons:
    get:
      summary: Get Failure Reasons
      operationId: getFailureReasons
      description: Returns a list of failure reasons with their details.
      responses:
        '200':
          description: Successful response with the list of failure reasons
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/FailureReasonList'
        '401':
          description: Unauthorized access
        '404':
          description: Resource not found
        '500':
          description: Internal Server Error
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/mnt-rest-result'
      tags:
      - FailureReasons
components:
  schemas:
    mnt-rest-result:
      type: object
      additionalProperties: true
      properties:
        http-code:
          type: integer
          example: 500
        cpm-code:
          type: integer
          example: 34110
        description:
          type: string
          example: Server has encountered error while processing the REST request
        module-name:
          type: string
          example: MnT
        internal-error-info:
          type: string
          example: This host is not a MnT node. MnT REST APIs can not be executed on this node.
        requested-operation:
          type: string
          example: Get By Type
        resource-id:
          type: string
          example: dummy
        resource-name:
          type: string
          example: dummy
        resource-type:
          type: string
          example: ActiveCount
        status:
          type: string
          example: SERVER_ERROR
    FailureReasonList:
      description: List of failure reasons
      type: object
      xml:
        name: failureReasonList
      properties:
        failureReason:
          type: array
          items:
            $ref: '#/components/schemas/FailureReason'
    FailureReason:
      type: object
      properties:
        id:
          type: string
          xml:
            attribute: true
        code:
          type: string
          example: 100001 AUTHMGR-5-FAIL Authorization failed for client
        cause:
          type: string
          example: This may or may not be indicating a violation
        resolution:
          type: string
          example: Please review and resolve according to your organization's policy
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic