{"type":"api","title":"Create Policy 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":["Policy - Policy Group"],"description":"Create a new Policy Group","operationId":"CreatePolicyGroup","requestBody":{"description":"Policy 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","sd-routing"]},"profiles":{"type":"array","description":"list of profile ids that belongs to the policy group","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"],"additionalProperties":false,"$$ref":"#/components/schemas/PolicygroupCommonPostRequest_profileIdObjDef"},"uniqueItems":true,"additionalProperties":false},"fromPolicyGroup":{"type":"object","description":"from another policy 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/PolicygroupCommonPostRequest_fromPolicyGroupDef"}},"required":["name","description","solution"],"additionalProperties":false,"$$ref":"#/components/schemas/PolicygroupCommonPostRequest_SchemaPayload"},"examples":{"CEDGE-PolicyGroup1-NY":{"value":{"name":"CEDGE-PolicyGroup1-NY","description":"CEDGE Policy 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/PolicygroupCommonPostRequest_CEDGE-PolicyGroup1-NY"},"CEDGE-PolicyGroup1-COPY":{"value":{"name":"CEDGE-PolicyGroup1-COPY","description":"Copy Policy Group from EEBE1AaD-DbC6-A9C2-E5F2-a9aFDD993F99","solution":"sdwan","fromPolicyGroup":{"copy":"EEBE1AaD-DbC6-A9C2-E5F2-a9aFDD993F99"}},"$$ref":"#/components/examples/PolicygroupCommonPostRequest_CEDGE-PolicyGroup1-COPY"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"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}"},"profiles":{"type":"array","description":"(Optional - only applicable for AON) List of profile ids that belongs to the policy group","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"profileType":{"type":"string","enum":["global"]}},"required":["id","profileType"],"additionalProperties":false,"$$ref":"#/components/schemas/PolicygroupCommonPostResponse_profileObjDef"}}},"required":["id"],"additionalProperties":false,"$$ref":"#/components/schemas/PolicygroupCommonPostResponse_SchemaPayload"},"examples":{"example_1":{"value":{"id":"3EEF02A6-DD2A-bE42-ae6d-cda4CF2C30ac"},"$$ref":"#/components/examples/PolicygroupCommonPostResponse_example_1"},"example_2":{"value":{"id":"5eDFc2F7-3F0A-0Efe-6E1f-E5caAE0C6060","profiles":[{"id":"002C4d1e-AA45-8e75-8CAB-C9CA0FE882a6","profileType":"global"}]},"$$ref":"#/components/examples/PolicygroupCommonPostResponse_example_2"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Policy Group-write","method":"post","path":"/v1/policy-group"}}