openapi: 3.2.0
info:
  title: Cisco Ise Mdm Action API
  version: '1.0'
  description: 'Operations tagged mdm-action 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-action
paths:
  /<mdm-server>/{api_path}/action/actionType=<action type>:
    post:
      tags:
      - mdm-action
      summary: Send the action commands to the MDM server
      description: This API allows Cisco ISE to send action command to MDM to perform certain actions, like wipe out config,
        etc. Supports guid & guidhn as device identifiers while sending action requests.
      parameters:
      - name: api_path
        in: path
        description: api_path obtained from GET operation of mdm-server-info
        required: true
        schema:
          type: string
      - name: actionType
        in: query
        description: full_wipe, corporate_wipe or pin_lock
        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-action-response'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/mdm-action-request'
  /<mdm-server-ip>/{api_path}/action/actionType=<action type>:
    post:
      tags:
      - mdm-action
      summary: Send the action commands to the MDM server
      description: This API allows Cisco ISE to send action command to MDM to perform certain actions, like wipe out config,
        etc. Currently in version 1, ways to wipeout configs are the only required actions.
      parameters:
      - name: api_path
        in: path
        description: api_path obtained from GET operation of mdm-server-info
        required: true
        schema:
          type: string
      - name: actionType
        in: query
        description: full_wipe, corporate_wipe or pin_lock
        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-action'
components:
  schemas:
    mdm-action-request:
      type: object
      properties:
        identifier:
          type: object
          properties:
            guid:
              type: string
              example: '000000000000'
    mdm-action-response:
      type: object
      properties:
        name:
          type: string
          example: action
        api_version:
          type: integer
          example: 3
        deviceList:
          type: object
          properties:
            device:
              type: object
              properties:
                guid:
                  type: string
                  example: '000000000000'
                result:
                  type: object
                  properties:
                    action_status:
                      type: boolean
                      example: true
                    failure_reason:
                      type: string
                      example: something not compliant
    mdm-action:
      type: object
      properties:
        name:
          type: string
          example: action
        api_version:
          type: integer
          example: 2
        deviceList:
          type: object
          properties:
            device:
              type: object
              properties:
                macaddress:
                  type: string
                  example: '000000000000'
                result:
                  type: object
                  properties:
                    action_status:
                      type: boolean
                      example: true
                    failure_reason:
                      type: string
                      example: something not compliant
x-refined-from:
- cisco-ise-mdm-mobile-device-management.yaml
- cisco-ise-mdm-older-versions.yaml