{"type":"api","title":"Deploy 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":"deploy Topology group to devices","operationId":"deployTopologyGroup","parameters":[{"name":"topologyGroupId","in":"path","description":"Topology Group Id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deactivateTopology":{"type":"boolean","default":false}},"required":[],"additionalProperties":false,"$$ref":"#/components/schemas/TopologygroupCommonDeployPostRequest_SchemaPayload"},"examples":{}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"parentTaskId":{"type":"string","minLength":1,"$$ref":"#/components/schemas/CommonCommonDefs_nonEmptyStringDef"}},"required":["parentTaskId"],"additionalProperties":false,"$$ref":"#/components/schemas/TopologygroupCommonDeployPostResponse_SchemaPayload"},"examples":{"example_1":{"value":{"parentTaskId":"deploy-topology-group-73C544A7-5B4d-8f6c-feB4-b4af830b0d2c"},"$$ref":"#/components/examples/TopologygroupCommonDeployPostResponse_example_1"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Topology Group \u003e Device \u003e Activate-write","method":"post","path":"/v1/topology-group/{topologyGroupId}/device/deploy"}}