openapi: 3.2.0
info:
  title: Cisco Ise Mdm Messaging API
  version: '1.0'
  description: 'Operations tagged mdm-messaging across 2 of this provider''s published API definitions: cisco-ise-mdm-mobile-device-management.yaml,
    cisco-ise-mdm-older-versions.yaml. Each path carries the servers of the definition it was published in.'
  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.
    derived_view: Per-tag view of cisco-ise-mdm-mobile-device-management.yaml, the provider's source document. Operations
      and schemas are the provider's, unmodified; only the partition is ours.
    derived_from: cisco-ise-mdm-mobile-device-management.yaml
    operation_coverage: 1/2
  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/
tags:
- name: mdm-messaging
paths:
  /<mdm-server>/{api_path}/sendmessage:
    put:
      tags:
      - mdm-messaging
      summary: Send the message through MDM server to end user
      description: 'This API allows Cisco ISE to send messages through MDM to end user mobile devices (assuming MDM has messaging
        system to communicate with mobile devices).   Supports guid & guidhn as device identifiers while sending action requests.<br><br>
        **Note**: : Implementation of this API is optional at this point, vendor implementation of this  API will also need
        to add flag “messaging_support” in response of API#1 to signify that the messaging API  is implemented.'
      parameters:
      - name: api_path
        in: path
        description: api_path obtained from GET operation of mdm-server-info
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        description: '{username}:{password}'
        required: true
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/mdm-messaging-response'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/mdm-messaging-request'
  /<mdm-server-ip>/{api_path}/sendmessage:
    put:
      tags:
      - mdm-messaging
      summary: Send the message through MDM server to end user
      description: 'This API allows Cisco ISE to send messages through MDM to end user mobile devices (assuming MDM has messaging
        system to communicate with mobile devices).   Supports guid & guidhn as device identifiers while sending action requests.<br><br>
        **Note**: : Implementation of this API is optional at this point, vendor implementation of this  API will also need
        to add flag “messaging_support” in response of API#1 to signify that the messaging API  is implemented.'
      parameters:
      - name: api_path
        in: path
        description: api_path obtained from GET operation of mdm-server-info
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        description: '{username}:{password}'
        required: true
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/mdm-messaging'
components:
  schemas:
    mdm-messaging-request:
      type: object
      properties:
        identifier:
          type: object
          properties:
            guid:
              type: string
              example: '000000000000'
        message:
          type: object
          properties:
            message_type:
              type: string
              example: Alert
            message_header:
              type: string
              example: Need your action in the next 10 minutes
            message_body:
              type: string
              example: Your device is not compliant for the following reason, please take action in the next 10 minutes, otherwise
                you network access will be revoked
    mdm-messaging-response:
      type: object
      properties:
        name:
          type: string
          example: sendmessage
        api_version:
          type: integer
          example: 3
        deviceList:
          type: object
          properties:
            device:
              type: object
              properties:
                guid:
                  type: string
                  example: '000000000000'
                result:
                  type: object
                  properties:
                    message_status:
                      type: boolean
                      example: false
                    failure_reason:
                      type: string
                      example: something happened, message is not sent
    mdm-messaging:
      type: object
      properties:
        name:
          type: string
          example: sendmessage
        api_version:
          type: integer
          example: 2
        deviceList:
          type: object
          properties:
            device:
              type: object
              properties:
                result:
                  type: object
                  properties:
                    message_status:
                      type: boolean
                      example: false
                    failure_reason:
                      type: string
                      example: something happened, message is not sent
x-refined-from:
- cisco-ise-mdm-mobile-device-management.yaml
- cisco-ise-mdm-older-versions.yaml