{"type":"api","title":"Get Identity User Groups","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/65ee78ac-32f3-329c-b00c-b5d29b6bef36","info":{"title":"UX 1.0 Configuration","description":"Configuration of UX 1.0 device and policy.\n\nIncludes API operations for the following:\n- Managing original SD-WAN device configurations and policy configurations\n- Device templates and feature templates\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Configuration - Ise Server"],"description":"Get all identity user groups","operationId":"getIdentityUserGroups","requestBody":{"description":"Get Users Groups from ISE associated with Active Directory Domain. Body can be an empty object or null to return all User Groups. For filtering a group must be specified, you cannot use a regex.","content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"string","example":"Cert Publishers"}},"$$ref":"#/components/schemas/UserGroupsBody"},"examples":{"User Group Filter":{"description":"User Group Filter","value":{"filter":"Cert Publishers"}},"User Group Filter Empty Braces":{"description":"User Group Filter Empty Braces","value":{}},"User Group Filter No Entry":{"description":"User Group Filter No Entry"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"ERSActiveDirectoryGroups":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"b1.com/Builtin/Administrators"},"sid":{"type":"string","example":"b1.com/S-1-5-32-544"},"type":{"type":"string","example":"BUILTIN, DOMAIN LOCAL"}},"$$ref":"#/components/schemas/UsergroupObject"}}},"$$ref":"#/components/schemas/ERSActiveDirectoryGroups"}},"description":"Data Object for Users Groups call","$$ref":"#/components/schemas/UserGroupsDataObject"},"header":{"type":"object","properties":{"columns":{"type":"object","example":{}},"fields":{"type":"object","example":{}},"generatedOn":{"type":"integer","format":"int32","example":1643067620683},"viewKeys":{"type":"object","example":{}}},"description":"Header for Response","$$ref":"#/components/schemas/HeaderObject"}},"description":"User Groups Data from ISE active directory domain","$$ref":"#/components/schemas/UserGroupsResponse"}}}},"400":{"description":"bad input parameter"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"method":"post","path":"/template/policy/ise/identity/usergroups"}}