Endpoint API Specification

Specification Details

Property Value

Title

Cisco ISE API - Endpoints

OpenAPI Version

3.0.3

API Version

1.0.0

ISE Version

3.4

Base URL

{server}:443/api/v1/endpoint

Authentication

HTTP Basic (ERS Admin credentials)

Endpoints

7

API Comparison

API Base Path Port Features

ERS

/ers/config/endpoint

9060

Basic CRUD, XML/JSON

OpenAPI

/api/v1/endpoint

443

Bulk operations, advanced filtering, device summaries

Endpoints

Endpoint Methods Description

/api/v1/endpoint

GET, POST

List all endpoints with advanced filtering, create endpoint

/api/v1/endpoint/{value}

GET, PUT, DELETE

Get/update/delete endpoint by ID or MAC

/api/v1/endpoint/bulk

POST, PUT, DELETE

Bulk create/update/delete operations

/api/v1/endpoint/deviceType/summary

GET

Device type distribution summary

/api/v1/endpoint/getRejected

GET

List rejected endpoints

/api/v1/endpoint/releaseRejectedEndpoints

PUT

Release rejected endpoints

/api/v1/endpointTask

GET

Get bulk operation task status

Advanced Filtering

The OpenAPI endpoint supports powerful filtering:

Operator Description

EQ

Equals

NEQ

Not Equals

GT

Greater Than

LT

Less Than

STARTSW

Starts With

NSTARTSW

Not Starts With

ENDSW

Ends With

NENDSW

Not Ends With

CONTAINS

Contains

NCONTAINS

Not Contains
Example Filter
# Find all endpoints with MAC starting with AA:BB
curl -X GET "https://ise:443/api/v1/endpoint?filter=mac.STARTSW.AA:BB"

Bulk Operations

# Bulk delete endpoints
curl -X DELETE "https://ise:443/api/v1/endpoint/bulk" \
  -H "Content-Type: application/json" \
  -d '["id1", "id2", "id3"]'

# Check task status
curl -X GET "https://ise:443/api/v1/endpointTask/\{taskId\}"

Download

  • Repository: specs/ise/ise-openapi-endpoint.json

  • Size: 31 KB

  • Lines: 1,004

Related