Cisco Identity Services Engine

Cisco Identity Services Engine Identitygroups API

The identitygroups API from Cisco Identity Services Engine — 4 operation(s) for identitygroups.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 8

GET /ers/config/identitygroup/name/{name} Get identity group by name #
GET /ers/config/identitygroup/{id} Get identity group by ID #
DELETE /ers/config/identitygroup/{id} Delete identity group #
PATCH /ers/config/identitygroup/{id} Update part of the identity group by ID #
PUT /ers/config/identitygroup/{id} Update identity group #
GET /ers/config/identitygroup Get all identity groups #
POST /ers/config/identitygroup Create identity group #
GET /ers/config/identitygroup/versioninfo Get identity group version information #

Documentation

📖
Documentation
https://developer.cisco.com/docs/identity-services-engine/latest/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cisco-ise/refs/heads/main/openapi/cisco-ise-identitygroups-api-openapi.yml

Other Resources

🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/ERS-Open-API/ERS_APIs.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/TrustSec.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/policy.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/exim.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/rbac.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/deployment.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/certificates.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/upgrade.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/5G.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/alarms.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/prometheus-alertmanager.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/pxgrid-direct.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/webhooks.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/licensing.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/duo-identity-sync.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/endpoints.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/ise-profiler.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/ipsec.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/oidc.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/mfa.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/BackupRestore.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/patch-hot-patch.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/Repository.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/custom-attributes.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/data-connect.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/pxgrid-cloud.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/api-sgt-reservation.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/System-Settings.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/endpoint-replication.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/lsd-settings.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Open-API/task-service.yaml
🔗
OpenAPI Source
https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/endpoints/Monitoring-Open-API/monitoring-open-api.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cisco-ise:cisco-ise-identitygroups-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cisco-ise-identitygroups-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Identity Groups API allows the client to search identity groups.
  version: 1.0.0
  title: Identity Groups Identitygroups API
  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/
tags:
- name: identitygroups
paths:
  /ers/config/identitygroup/name/{name}:
    get:
      tags:
      - identitygroups
      summary: Get identity group by name
      description: This API allows the client to get an identity group by name.
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- identity.identitygroup.1.1
        required: false
        schema:
          type: string
      - in: header
        name: HTTP X-CSRF-TOKEN Header
        description: Required Only if Enabled from GUI Example:- fetch
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identitygroup_name'
            application/xml:
              schema:
                $ref: '#/components/schemas/identitygroup_name'
      operationId: getErsConfigIdentitygroupNameByName
      x-operation-id-source: derived
  /ers/config/identitygroup/{id}:
    get:
      tags:
      - identitygroups
      summary: Get identity group by ID
      description: This API allows the client to get an identity group by ID.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- identity.identitygroup.1.1
        required: false
        schema:
          type: string
      - in: header
        name: HTTP X-CSRF-TOKEN Header
        description: Required Only if Enabled from GUI Example:- fetch
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identitygroup'
            application/xml:
              schema:
                $ref: '#/components/schemas/identitygroup'
      operationId: getErsConfigIdentitygroupById
      x-operation-id-source: derived
    delete:
      tags:
      - identitygroups
      summary: Delete identity group
      description: This API allows the client to delete an identity group.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- identity.identitygroup.1.1
        required: false
        schema:
          type: string
      - in: header
        name: HTTP X-CSRF-TOKEN Header
        description: Required Only if Enabled from GUI Example:- fetch
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identitygroup'
            application/xml:
              schema:
                $ref: '#/components/schemas/identitygroup'
      operationId: deleteErsConfigIdentitygroupById
      x-operation-id-source: derived
    patch:
      tags:
      - identitygroups
      summary: Update part of the identity group by ID
      description: This API allows the user to update part of the identity group by ID.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- identity.identitygroup.1.1
        required: false
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identitygroup'
            application/xml:
              schema:
                $ref: '#/components/schemas/identitygroup'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/patchRequest'
          application/xml:
            schema:
              $ref: '#/components/schemas/patchRequest'
      operationId: patchErsConfigIdentitygroupById
      x-operation-id-source: derived
    put:
      tags:
      - identitygroups
      summary: Update identity group
      description: This API allows the client to update an identity group.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- identity.identitygroup.1.1
        required: false
        schema:
          type: string
      - in: header
        name: HTTP X-CSRF-TOKEN Header
        description: The Token value from the GET X-CSRF-TOKEN fetch request
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Update'
            application/xml:
              schema:
                $ref: '#/components/schemas/Update'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/identitygroup'
          application/xml:
            schema:
              $ref: '#/components/schemas/identitygroup'
      operationId: putErsConfigIdentitygroupById
      x-operation-id-source: derived
  /ers/config/identitygroup:
    get:
      tags:
      - identitygroups
      summary: Get all identity groups
      description: 'This API allows the client to get all the identity groups.


        Filter:


        [name, description]


        To search guest users by using toDate column,follow the format:


        DD-MON-YY (Example:13-SEP-18)


        Day or Year:GET /ers/config/guestuser/?filter=toDate.CONTAINS.13


        Month:GET /ers/config/guestuser/?filter=toDate.CONTAINS.SEP


        Date:GET /ers/config/guestuser/?filter=toDate.CONTAINS.13-SEP-18


        Sorting:


        [name, description]'
      parameters:
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- identity.identitygroup.1.1
        required: false
        schema:
          type: string
      - in: header
        name: HTTP X-CSRF-TOKEN Header
        description: Required Only if Enabled from GUI Example:- fetch
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/search'
            application/xml:
              schema:
                $ref: '#/components/schemas/search'
      operationId: getErsConfigIdentitygroup
      x-operation-id-source: derived
    post:
      tags:
      - identitygroups
      summary: Create identity group
      description: This API creates an identity group.
      parameters:
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- identity.identitygroup.1.1
        required: false
        schema:
          type: string
      - in: header
        name: HTTP X-CSRF-TOKEN Header
        description: The Token value from the GET X-CSRF-TOKEN fetch request
        schema:
          type: string
      responses:
        201:
          description: Created
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/identitygroup'
          application/xml:
            schema:
              $ref: '#/components/schemas/identitygroup'
      operationId: postErsConfigIdentitygroup
      x-operation-id-source: derived
  /ers/config/identitygroup/versioninfo:
    get:
      tags:
      - identitygroups
      summary: Get identity group version information
      description: This API helps to retrieve the version information related to identity group.
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionInfo'
      operationId: getErsConfigIdentitygroupVersioninfo
      x-operation-id-source: derived
components:
  schemas:
    link1:
      type: object
      properties:
        rel:
          type: string
          example: self
        href:
          type: string
          example: <ise-ip>/ers/config/identitygroup/versioninfo
        type:
          type: string
          example: application/json
    IdentityGroup_name:
      type: object
      properties:
        id:
          type: string
          example: 9efe2310-8c01-11e6-996c-525400b48521
        name:
          type: string
          example: GuestType_Weekly (default)
        description:
          type: string
          example: Identity group mirroring the guest type
        parent:
          type: string
          example: NAC Group:NAC:IdentityGroups:User Identity Groups
        link:
          type: object
          properties:
            rel:
              type: string
              example: self
            href:
              type: string
              example: https://<ise-ip>:9060/ers/config/identitygroup/name/GuestType_Weekly (default)
            type:
              type: string
              example: application/json
    UpdatedField:
      type: object
      properties:
        field:
          type: string
          example: field1
        oldValue:
          type: string
          example: val_old
        newValue:
          type: string
          example: val_new
    version:
      type: object
      properties:
        currentServerVersion:
          type: string
          example: '1.1'
        supportedVersions:
          type: string
          example: 1.0,1.1
        link:
          $ref: '#/components/schemas/link1'
    VersionInfo:
      type: object
      properties:
        VersionInfo:
          $ref: '#/components/schemas/version'
    identitygroup_name:
      type: object
      properties:
        IdentityGroup:
          $ref: '#/components/schemas/IdentityGroup_name'
    IdentityGroup:
      type: object
      properties:
        id:
          type: string
          example: 9efe2310-8c01-11e6-996c-525400b48521
        name:
          type: string
          example: GuestType_Weekly (default)
        description:
          type: string
          example: Identity group mirroring the guest type
        parent:
          type: string
          example: NAC Group:NAC:IdentityGroups:User Identity Groups
        link:
          type: object
          properties:
            rel:
              type: string
              example: self
            href:
              type: string
              example: https://<ise-ip>:9060/ers/config/identitygroup/9efe2310-8c01-11e6-996c-525400b48521
            type:
              type: string
              example: application/json
    Update:
      type: object
      properties:
        UpdatedFieldsList:
          $ref: '#/components/schemas/UpdatedFieldsList'
    UpdatedFieldsList:
      type: object
      properties:
        updatedField:
          $ref: '#/components/schemas/UpdatedField'
        field:
          type: string
          example: some other field
        oldValue:
          type: string
          example: val_old
        newValue:
          type: string
          example: val_new
    SearchResult:
      type: object
      properties:
        total:
          type: integer
          example: 8
        resources:
          type: array
          example:
          - id: 9efe2310-8c01-11e6-996c-525400b48521
            name: GuestType_Weekly (default)
            description: Identity group mirroring the guest type
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/9efe2310-8c01-11e6-996c-525400b48521
              type: application/json
          - id: a19d5f00-8c01-11e6-996c-525400b48521
            name: OWN_ACCOUNTS (default)
            description: Default OWN_ACCOUNTS (default) User Group
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/a19d5f00-8c01-11e6-996c-525400b48521
              type: application/json
          - id: a1bb2030-8c01-11e6-996c-525400b48521
            name: GROUP_ACCOUNTS (default)
            description: Default GROUP_ACCOUNTS (default) User Group
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/a1bb2030-8c01-11e6-996c-525400b48521
              type: application/json
          - id: a1740510-8c01-11e6-996c-525400b48521
            name: Employee
            description: Default Employee User Group
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/a1740510-8c01-11e6-996c-525400b48521
              type: application/json
          - id: 9eee92b0-8c01-11e6-996c-525400b48521
            name: GuestType_Daily (default)
            description: Identity group mirroring the guest type
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/9eee92b0-8c01-11e6-996c-525400b48521
              type: application/json
          - id: ba775150-7a56-11eb-bf1f-0050568fa723
            name: GuestType_SocialLogin (default)
            description: Identity group mirroring the guest type
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/ba775150-7a56-11eb-bf1f-0050568fa723
              type: application/json
          - id: 9f048bb0-8c01-11e6-996c-525400b48521
            name: GuestType_Contractor (default)
            description: Identity group mirroring the guest type
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/9f048bb0-8c01-11e6-996c-525400b48521
              type: application/json
          - id: a176c430-8c01-11e6-996c-525400b48521
            name: ALL_ACCOUNTS (default)
            description: Default ALL_ACCOUNTS (default) User Group
            link:
              rel: self
              href: https://<ise-ip>:9060/ers/config/ers/config/identitygroup/a176c430-8c01-11e6-996c-525400b48521
              type: application/json
          items:
            properties:
              name:
                type: string
    patchRequestBody:
      type: object
      properties:
        any-resource-attribute:
          type: string
          example: some-updated-value
        another-resource-attribute:
          type: string
          example: some-updated-value
    search:
      type: object
      properties:
        SearchResult:
          $ref: '#/components/schemas/SearchResult'
    patchRequest:
      type: object
      properties:
        IdentityGroup:
          $ref: '#/components/schemas/patchRequestBody'
    identitygroup:
      type: object
      properties:
        IdentityGroup:
          $ref: '#/components/schemas/IdentityGroup'