Cisco Identity Services Engine Import Posture API

openapi: 3.2.0
info:
  title: Cisco ISE API - Exim Import Posture 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://10.127.96.224:443
  description: Inferred Url
tags:
- name: Import-Posture
paths:
  /api/v1/exim/import/posture:
    post:
      tags:
      - Import-Posture
      summary: Execute final import
      description: Execute the final import with all resolved conflicts
      operationId: executeImport
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
  /api/v1/exim/import/posture/complete-import:
    post:
      tags:
      - Import-Posture
      summary: Complete import setup from repository
      description: 'Simplified import API that retrieves the file from a repository and performs the import.  **What this API does:** 1. Retrieves the ZIP file from the specified repository 2. Auto-configure import details with default values (replace mode) 3. Allows optional policy-specific other condition mappings 4. Executes the import process  **Request Parameters:** - `fileName` (REQUIRED): Name of the file in the repository - `repoName` (REQUIRED): Repository name where the file is located - `encryptionKey` (OPTIONAL): Encryption key if the file is encrypted - `policyConditionMappings` (OPTIONAL): Array of policy-to-condition mappings  **Returns:** Success response with the import execution status.  **Note:** To check the detailed response, use the `/import/posture/status` endpoint. '
      operationId: executeCompleteImportWithFile
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompleteImportRequest'
              exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/conditions:
    get:
      tags:
      - Import-Posture
      summary: Get condition conflicts
      description: Retrieve list of conditions with conflicts that need resolution
      operationId: getConditionConflicts
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/ConditionConflict'
                  exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
    post:
      tags:
      - Import-Posture
      summary: Resolve condition conflicts
      description: Submit resolutions for condition conflicts
      operationId: resolveConditionConflicts
      requestBody:
        content:
          application/json:
            schema:
              type: array
              exampleSetFlag: true
              items:
                $ref: '#/components/schemas/ConditionConflictResolution'
                exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/EntityValidationResponse'
                  exampleSetFlag: false
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/details:
    get:
      tags:
      - Import-Posture
      summary: Get import details
      description: Retrieve current import configuration and method
      operationId: getImportDetails
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportDetailsRequest'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
    post:
      tags:
      - Import-Posture
      summary: Configure import details
      description: Set import configuration and method
      operationId: configureImportDetails
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImportDetailsRequest'
              exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '422':
          description: Unprocessable entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/othercondition:
    get:
      tags:
      - Import-Posture
      summary: Get condition mapping details
      description: Retrieve list of condition mappings for posture import
      operationId: getOtherConditions
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/ConditionMapping'
                  exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
    post:
      tags:
      - Import-Posture
      summary: Post condition mapping details
      description: save a list of condition mappings for posture import
      operationId: saveOtherConditions
      requestBody:
        content:
          application/json:
            schema:
              type: array
              exampleSetFlag: true
              items:
                $ref: '#/components/schemas/ConditionMapping'
                exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: Error-ModelName{namespace='java.lang', name='Void'}
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/policies:
    get:
      tags:
      - Import-Posture
      summary: Get policy conflicts
      description: Retrieve list of policies with conflicts that need resolution
      operationId: getPolicyConflicts
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/PolicyConflict'
                  exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
    post:
      tags:
      - Import-Posture
      summary: Resolve policy conflicts
      description: Submit resolutions for policy conflicts
      operationId: resolvePolicyConflicts
      requestBody:
        content:
          application/json:
            schema:
              type: array
              exampleSetFlag: true
              items:
                $ref: '#/components/schemas/PolicyConflictResolution'
                exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/EntityValidationResponse'
                  exampleSetFlag: false
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/remediations:
    get:
      tags:
      - Import-Posture
      summary: Get remediation conflicts
      description: Retrieve list of remediations with conflicts that need resolution
      operationId: getRemediationConflicts
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/RemediationConflict'
                  exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
    post:
      tags:
      - Import-Posture
      summary: Resolve remediation conflicts
      description: Submit resolutions for remediation conflicts
      operationId: resolveRemediationConflicts
      requestBody:
        content:
          application/json:
            schema:
              type: array
              exampleSetFlag: true
              items:
                $ref: '#/components/schemas/RemediationConflictResolution'
                exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/EntityValidationResponse'
                  exampleSetFlag: false
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/requirements:
    get:
      tags:
      - Import-Posture
      summary: Get requirement conflicts
      description: Retrieve list of requirements with conflicts that need resolution
      operationId: getRequirementConflicts
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/RequirementConflict'
                  exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
    post:
      tags:
      - Import-Posture
      summary: Resolve requirement conflicts
      description: Submit resolutions for requirement conflicts
      operationId: resolveRequirementConflicts
      requestBody:
        content:
          application/json:
            schema:
              type: array
              exampleSetFlag: true
              items:
                $ref: '#/components/schemas/RequirementConflictResolution'
                exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/EntityValidationResponse'
                  exampleSetFlag: false
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/rollback:
    post:
      tags:
      - Import-Posture
      summary: Rollback selected import resources
      description: Rollback the resources that were part of the last import operation
      operationId: rollbackImportResources
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/rollback/status:
    get:
      tags:
      - Import-Posture
      summary: Get current rollback posture status
      description: Retrieve the current posture rollback status
      operationId: getRollbackCurrentStatus
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/selectpolicies:
    post:
      tags:
      - Import-Posture
      summary: Select policies for import
      description: Submit list of selected policy IDs for import
      operationId: selectPoliciesForImport
      requestBody:
        content:
          application/json:
            schema:
              type: array
              exampleSetFlag: true
              items:
                $ref: '#/components/schemas/PolicyWithRules'
                exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/PolicyWithRules'
                  exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/selectrules:
    get:
      tags:
      - Import-Posture
      summary: Get available policies/rules for selection
      description: Retrieve list of policies with their rules for user selection
      operationId: getAvailablePoliciesForSelection
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/PolicyWithRules'
                  exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/status:
    get:
      tags:
      - Import-Posture
      summary: Get current import posture status
      description: Retrieve the current posture import status
      operationId: getImportPostureStatus
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportExecutionResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/stepstatus:
    get:
      tags:
      - Import-Posture
      summary: Get current import step status
      description: Retrieve the current step in the import process
      operationId: getImportStepStatus
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StepStatusResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/summary:
    get:
      tags:
      - Import-Posture
      summary: Get import summary
      description: Retrieve final summary of all policies to be imported
      operationId: getImportSummary
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                exampleSetFlag: true
                items:
                  $ref: '#/components/schemas/PolicyWithRules'
                  exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
  /api/v1/exim/import/posture/upload:
    post:
      tags:
      - Import-Posture
      summary: Upload file for exim import
      description: Upload a file to be imported, returns progress events
      operationId: uploadImportFile
      requestBody:
        content:
          multipart/form-data:
            schema:
              required:
              - file
              type: object
              properties:
                file:
                  type: string
                  description: The file to upload
                  format: binary
                  exampleSetFlag: true
              exampleSetFlag: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadProgressResponse'
                exampleSetFlag: false
        '201':
          description: Created
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
    delete:
      tags:
      - Import-Posture
      summary: Delete uploaded file
      description: Delete a previously uploaded file by filename
      operationId: deleteUploadedFile
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: Error-ModelName{namespace='java.lang', name='Void'}
                exampleSetFlag: false
        '204':
          description: No Content
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileValidationResponse'
                exampleSetFlag: false
components:
  schemas:
    ConditionConflict:
      title: ConditionConflict
      type: object
      properties:
        action:
          $ref: '#/components/schemas/ConflictAction'
          exampleSetFlag: true
        attributeConflicts:
          type: array
          description: Names of attributes that are in conflict for this condition.
          exampleSetFlag: true
          items:
            type: string
            exampleSetFlag: false
        condition:
          type: array
          description: List of conflicting condition objects.
          exampleSetFlag: true
          items:
            type: object
            additionalProperties:
              type: object
              exampleSetFlag: false
            exampleSetFlag: false
        id:
          type: string
          description: Condition ID with conflict
          exampleSetFlag: true
        isValidate:
          type: boolean
          description: 'A flag which specifies whether to enable or disable validation during conflict resolution. When true, validation is performed. When false, validation is skipped. '
          example: false
          exampleSetFlag: true
        name:
          type: string
          description: Condition name
          exampleSetFlag: true
        policy:
          type: array
          description: List of policies and requirements where the condition is used.
          exampleSetFlag: true
          items:
            $ref: '#/components/schemas/PolicyWithRequirements'
            exampleSetFlag: false
      description: Conflict details for a posture condition.
      exampleSetFlag: false
    UploadProgressResponseEvents:
      title: UploadProgressResponseEvents
      type: object
      properties:
        message:
          type: string
          description: Additional message about the upload status
          exampleSetFlag: true
        status:
          type: string
          description: Current status of upload
          exampleSetFlag: true
      description: Single upload progress event.
      exampleSetFlag: false
    RemediationConflict:
      title: RemediationConflict
      type: object
      properties:
        action:
          $ref: '#/components/schemas/ConflictAction'
          exampleSetFlag: true
        attributeConflicts:
          type: array
          description: Names of attributes that are in conflict for this remediation.
          exampleSetFlag: true
          items:
            type: string
            exampleSetFlag: false
        id:
          type: string
          description: Remediation ID
          exampleSetFlag: true
        isValidate:
          type: boolean
          description: 'A flag which specifies whether to enable or disable validation during conflict resolution. When true, validation is performed. When false, validation is skipped. '
          example: false
          exampleSetFlag: true
        name:
          type: string
          description: Remediation name
          exampleSetFlag: true
        policy:
          type: array
          description: List of policies and requirements where the remediation is used.
          exampleSetFlag: true
          items:
            $ref: '#/components/schemas/PolicyWithRequirements'
            exampleSetFlag: false
        remediation:
          type: array
          description: List of conflicting remediation objects.
          exampleSetFlag: true
          items:
            type: object
            additionalProperties:
              type: object
              exampleSetFlag: false
            exampleSetFlag: false
      description: Conflict details for a remediation object.
      exampleSetFlag: false
    CompleteImportRequest:
      title: CompleteImportRequest
      required:
      - fileName
      - repoName
      type: object
      properties:
        encryptionKey:
          type: string
          description: Optional encryption 

# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-ise/refs/heads/main/openapi/cisco-ise-import-posture-api-openapi.yml