{"type":"api","title":"Edit Topology Group","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/8bb2440c-2dd0-310b-8b55-fbbf55ba4b5c","info":{"title":"UX 2.0 Configuration","description":"Configuration of UX 2.0 device, policy, and topology\n\nIncludes API operations for the following\n- Configuration Groups (SD-WAN and SD-Routing)\n- Policy Groups\n- Topology Groups\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Topology - Topology Group"],"description":"Edit a Topology Group","operationId":"EditTopologyGroup","parameters":[{"name":"topologyGroupId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Topology Group","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","pattern":"^[^&\u003c\u003e! \"]+$","minLength":1,"maxLength":128,"$$ref":"#/components/schemas/CommonCommonDefs_cgFpPpNameDef"},"description":{"type":"string"},"solution":{"type":"string","enum":["sdwan"]},"profiles":{"type":"array","description":"list of profile ids that belongs to the topology group","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"],"additionalProperties":false,"$$ref":"#/components/schemas/TopologygroupCommonPutRequest_profileIdObjDef"},"uniqueItems":true,"additionalProperties":false}},"required":["name","description","solution"],"additionalProperties":false,"$$ref":"#/components/schemas/TopologygroupCommonPutRequest_SchemaPayload"},"examples":{"CEDGE-TopologyGroup1-NY":{"value":{"name":"CEDGE-TopologyGroup1-NY","description":"CEDGE Topology Group 1 for devices at site NY","solution":"sdwan","profiles":[{"id":"EEBE1AaD-DbC6-A9C2-E5F2-a9aFDD993FED"},{"id":"4D7eb1e4-Bf34-9aeA-58d8-C86824ECF8f4"},{"id":"4C56e3c3-C67F-Cf66-d02f-8c666bd005CC"}]},"$$ref":"#/components/examples/TopologygroupCommonPutRequest_CEDGE-TopologyGroup1-NY"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"string"},"example":{"Solution":"Mobility","name":"Awesome Topology group"}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Topology Group-write","method":"put","path":"/v1/topology-group/{topologyGroupId}"}}