{"type":"api","title":"Create 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":"Create a new Topology Group","operationId":"CreateTopologyGroup","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/TopologygroupCommonPostRequest_profileIdObjDef"},"uniqueItems":true,"additionalProperties":false},"fromTopologyGroup":{"type":"object","description":"from another topology group","oneOf":[{"properties":{"copy":{"type":"string","pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}","$$ref":"#/components/schemas/CommonCommonDefs_uuidDef"}},"required":["copy"],"additionalProperties":false}],"$$ref":"#/components/schemas/TopologygroupCommonPostRequest_fromTopologyGroupDef"}},"required":["name","description","solution"],"additionalProperties":false,"$$ref":"#/components/schemas/TopologygroupCommonPostRequest_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/TopologygroupCommonPostRequest_CEDGE-TopologyGroup1-NY"},"CEDGE-TopologyGroup1-COPY":{"value":{"name":"CEDGE-TopologyGroup1-COPY","description":"Copy Topology Group from EEBE1AaD-DbC6-A9C2-E5F2-a9aFDD993F99","solution":"sdwan","fromTopologyGroup":{"copy":"EEBE1AaD-DbC6-A9C2-E5F2-a9aFDD993F99"}},"$$ref":"#/components/examples/TopologygroupCommonPostRequest_CEDGE-TopologyGroup1-COPY"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"string"},"example":"TODO"}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Topology Group-write","method":"post","path":"/v1/topology-group"}}