openapi: 3.2.0
info:
  title: ISE ERS Ctsmatrix API
  version: 3.1.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://{server}:{port}/ers/config
  description: Append /ctsapi/v2 or /ctsapi/v3 to above URL while accessing CTS APIs
  variables:
    server:
      description: The host where the API is rooted
      default: localhost
    port:
      description: The port no for CTS APIs is 9063 and for other APIs it is 443
      default: '443'
security:
- HTTPBasicAuthentication: []
tags:
- name: ctsmatrix
paths:
  /ctsmatrix/:
    post:
      tags:
      - ctsmatrix
      summary: TrustSec-Query
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/trustsec.ctsmatrix'
            example:
              CtsMatrix:
                pushId: '123456'
                offset: 0
                srcSgtArr: []
                limit: 500
                dstSgtArr:
                - 0C
        required: true
      responses:
        '201':
          description: Created
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '406':
          description: Not Acceptable
        '415':
          description: UnSupported Media Type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '500':
          description: Internal Server Error
  /ctsapi/v2/ctsmatrix/:
    post:
      tags:
      - ctsmatrix
      summary: TrustSec-Query
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/trustsec.ctsmatrix'
            example:
              CtsMatrix:
                pushId: '123456'
                offset: 0
                srcSgtArr: []
                limit: 500
                dstSgtArr:
                - 0C
        required: true
      responses:
        '201':
          description: Created
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '406':
          description: Not Acceptable
        '415':
          description: UnSupported Media Type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '500':
          description: Internal Server Error
  /ctsapi/v3/ctsmatrix/:
    post:
      tags:
      - ctsmatrix
      summary: TrustSec-Query
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/trustsec.ctsmatrix'
            example:
              CtsMatrix:
                pushId: '123456'
                offset: 0
                srcSgtArr: []
                limit: 500
                dstSgtArr:
                - 0C
        required: true
      responses:
        '201':
          description: Created
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '406':
          description: Not Acceptable
        '415':
          description: UnSupported Media Type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '500':
          description: Internal Server Error
components:
  schemas:
    CtsMatrix:
      properties:
        deviceName:
          title: deviceName
          type: string
          description: ''
          example: null
        deviceId:
          title: deviceId
          type: string
          description: ''
          example: null
        pushId:
          title: pushId
          type: string
          description: 'Value range: 2 to 65519 or -1 to auto-generate'
          example: null
        policyType:
          title: policyType
          type: string
          description: ''
          example: null
        policyVerId:
          title: policyVerId
          type: string
          description: ''
          example: null
        offset:
          title: offset
          type: number
          description: ''
          example: null
        max:
          title: max
          type: number
          description: ''
          example: null
        limit:
          title: limit
          type: number
          description: ''
          example: null
        reportConfigType:
          title: reportConfigType
          type: string
          description: ''
          example: null
        version:
          title: version
          type: string
          description: ''
          example: null
        globalMonitorModeEnabled:
          title: globalMonitorModeEnabled
          type: boolean
          description: ''
          example: null
        srcSgtArr:
          title: srcSgtArr
          type: array
          description: ''
          example: null
          items:
            type: string
            example: null
        dstSgtArr:
          title: dstSgtArr
          type: array
          description: ''
          example: null
          items:
            type: string
            example: null
        sgts:
          title: sgts
          type: array
          description: ''
          example: null
          items:
            properties:
              tag:
                title: tag
                type: string
                description: ''
                example: null
              genId:
                title: genId
                type: string
                description: ''
                example: null
            example: null
        sgacls:
          title: sgacls
          type: array
          description: ''
          example: null
          items:
            properties:
              name:
                title: name
                type: string
                description: ''
                example: null
              genId:
                title: genId
                type: string
                description: ''
                example: null
            example: null
        cells:
          properties:
            dstSgt:
              title: dstSgt
              type: string
              description: ''
              example: null
            dstSgtGenID:
              title: dstSgtGenID
              type: string
              description: ''
              example: null
            srcSgt:
              title: srcSgt
              type: string
              description: ''
              example: null
            srcSgtGenID:
              title: srcSgtGenID
              type: string
              description: ''
              example: null
            refreshTimer:
              title: refreshTimer
              type: string
              description: ''
              example: null
            colCells:
              properties:
                dstSgt:
                  title: dstSgt
                  type: string
                  description: ''
                  example: null
                srcSgt:
                  title: srcSgt
                  type: string
                  description: ''
                  example: null
                sgacls:
                  properties:
                    name:
                      title: name
                      type: string
                      description: ''
                      example: null
                    sgaclGenID:
                      title: sgaclGenID
                      type: string
                      description: ''
                      example: null
                    protocol:
                      title: protocol
                      type: string
                      description: ''
                      example: null
                  example: null
                monitorMode:
                  title: monitorMode
                  type: string
                  description: ''
                  example: null
                steeringPolicy:
                  title: steeringPolicy
                  type: array
                  description: ''
                  example: null
                  items:
                    type: string
                    example: null
              example: null
          example: null
      example:
        CtsMatrix:
          pushId: '123456'
          offset: 0
          srcSgtArr: []
          limit: 500
          dstSgtArr:
          - 0C
    trustsec.ctsmatrix:
      required:
      - CtsMatrix
      type: object
      properties:
        CtsMatrix:
          $ref: '#/components/schemas/CtsMatrix'
      example: null
    ERSResponse:
      type: object
      properties:
        operation:
          type: string
          example: Operation
        messages:
          type: array
          example: null
          items:
            properties:
              title:
                type: string
                example: title
              type:
                type: string
                example: type
              code:
                type: string
                example: code
            example: null
      example: null
  securitySchemes:
    HTTPBasicAuthentication:
      type: http
      scheme: basic