openapi: 3.2.0
info:
  title: Cisco ISE API - TrustSec Trustsec devices report 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://172.23.118.207:443
  description: Inferred Url
tags:
- name: Trustsec devices report
paths:
  /api/v1/trustsec/policy/device-report:
    get:
      tags:
      - Trustsec devices report
      summary: Get trustsec policy report of all the  Trustsec devices
      description: Get trustsec policy report of all the  Trustsec devices
      operationId: getCTSDevicesReport
      responses:
        '200':
          description: Trustsec policy report from network-devices.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CTSDevicesReport'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
  /api/v1/trustsec/policy/device-report/network-device/{name}:
    get:
      tags:
      - Trustsec devices report
      summary: Get trustsec policy report of a Trustsec device
      description: Get trustsec policy report of a Trustsec device
      operationId: getCTSDevicesReportByND
      parameters:
      - name: name
        in: path
        description: Name of the network-device
        required: true
        style: simple
        schema:
          type: string
          exampleSetFlag: true
      responses:
        '200':
          description: Trustsec policy report of a Trustsec device
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CTSDeviceReport'
                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
components:
  schemas:
    CTSDeviceReport:
      title: CTSDeviceReport
      type: object
      properties:
        ipAddress:
          type: string
          description: IP address of the network-device
          example: 10.0.10.120
          exampleSetFlag: true
        name:
          type: string
          description: Name of the network-device
          example: tsn-1
          exampleSetFlag: true
        policyUpdatedTime:
          type: string
          description: Timestamp when the policy was updated in Cisco ISE.
          example: '2021-01-30T08:30:00.000Z'
          exampleSetFlag: true
        policyVersionId:
          type: string
          description: Trustsec configuration version identifier
          example: 1c-d-1905b785abd
          exampleSetFlag: true
        pullId:
          type: string
          description: Identifier generated by netowrk-device for tracking the trsustsec communication with ISE
          example: '123456'
          exampleSetFlag: true
        pushId:
          type: string
          description: Identifier generated by ISE for tracking the trsustsec communication with this the network-device
          example: '12345'
          exampleSetFlag: true
        state:
          type: string
          description: State indicate the last communication done from ISE to network-device or vice versa
          example: ENVDATA_DOWNLOAD
          exampleSetFlag: true
          enum:
          - COA_ERROR
          - COA_SENT
          - DEVICE_REPORT
          - ENVDATA_DOWNLOAD
          - SGACL_DOWNLOAD
          - STEERING_CONTRACT_DOWNLOAD
          - STEERING_POLICY_DOWNLOAD
          - TRUSTSEC_POLICY_DOWNLOAD
        status:
          type: string
          description: Status of the ISE and network-device  communication
          example: COA_SENT
          exampleSetFlag: true
          enum:
          - COA_ACK
          - COA_APPROVED
          - COA_ERROR
          - COA_NACK
          - COA_SENT
          - COA_TIMED_OUT
          - ENV_REQUEST
          - ENV_REQUEST_FAILED
          - ENV_REQUEST_SUCCESS
          - REPORT_VALIDATION_ERROR
          - REPORT_VALIDATION_SUCCESS
          - REPORT_VALIDATION_WARNING
          - TIMED_OUT
          - UPDATE
          - UPDATE_ERROR
          - UPDATE_SUCCESS
          - UPDATE_TIMED_OUT
        statusUpdatedTime:
          type: string
          description: Timestamp when the status was updated for the network-device
          example: '2021-01-30T08:30:00.000Z'
          exampleSetFlag: true
      description: Network-device Trustsec policy report
      exampleSetFlag: false
    CTSDevicesReport:
      title: CTSDevicesReport
      type: object
      properties:
        response:
          type: array
          exampleSetFlag: true
          items:
            $ref: '#/components/schemas/CTSDeviceReport'
            exampleSetFlag: false
        version:
          type: string
          example: 1.0.0
          exampleSetFlag: true
      exampleSetFlag: false
    Error:
      title: Error
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: integer
          format: int32
          example: 400
          exampleSetFlag: true
        message:
          type: string
          example: Some error occurred
          exampleSetFlag: true
      exampleSetFlag: false