{"files":{"SKILL.md":"---\nname: policyclient\ndescription: \"PolicyClient API skill. Use when working with PolicyClient for subscriptions, providers. Covers 10 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# PolicyClient\nAPI version: 2019-06-01\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://management.azure.com\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /providers/Microsoft.Authorization/policyDefinitions -- retrieve built-in policy definitions\n3. Explore available endpoints below\n\n## Endpoints\n10 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Subscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName} | Creates or updates a policy definition in a subscription. |\n| DELETE | /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName} | Deletes a policy definition in a subscription. |\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName} | Retrieves a policy definition in a subscription. |\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions | Retrieves policy definitions in a subscription |\n\n### Providers\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName} | Retrieves a built-in policy definition. |\n| PUT | /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName} | Creates or updates a policy definition in a management group. |\n| DELETE | /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName} | Deletes a policy definition in a management group. |\n| GET | /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName} | Retrieve a policy definition in a management group. |\n| GET | /providers/Microsoft.Authorization/policyDefinitions | Retrieve built-in policy definitions |\n| GET | /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions | Retrieve policy definitions in a management group |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Update a policyDefinition?\" -> PUT /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n- \"Delete a policyDefinition?\" -> DELETE /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n- \"Get policyDefinition details?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n- \"List all policyDefinitions?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api PolicyClient\n@base https://management.azure.com\n@version 2019-06-01\n@auth OAuth2\n@common_fields {api-version: any # The API version to use for the operation.}\n@endpoints 10\n@toc subscriptions(4), providers(6)\n\n@group subscriptions\n@endpoint PUT /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n@desc Creates or updates a policy definition in a subscription.\n@required {policyDefinitionName: any # The name of the policy definition to create., parameters: any # The policy definition properties., subscriptionId: any # The ID of the target subscription.}\n@returns(201) Created - Returns information about the policy definition.\n\n@endpoint DELETE /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n@desc Deletes a policy definition in a subscription.\n@required {policyDefinitionName: any # The name of the policy definition to delete., subscriptionId: any # The ID of the target subscription.}\n@returns(200) OK\n@returns(204) No Content\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n@desc Retrieves a policy definition in a subscription.\n@required {policyDefinitionName: any # The name of the policy definition to get., subscriptionId: any # The ID of the target subscription.}\n@returns(200) OK - Returns information about the policy definition.\n\n@endgroup\n\n@group providers\n@endpoint GET /providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n@desc Retrieves a built-in policy definition.\n@required {policyDefinitionName: any # The name of the built-in policy definition to get.}\n@returns(200) OK - Returns information about the built-in policy definition.\n\n@endpoint PUT /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n@desc Creates or updates a policy definition in a management group.\n@required {policyDefinitionName: any # The name of the policy definition to create., parameters: any # The policy definition properties., managementGroupId: any # The ID of the management group.}\n@returns(201) Created - Returns information about the policy definition.\n\n@endpoint DELETE /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n@desc Deletes a policy definition in a management group.\n@required {policyDefinitionName: any # The name of the policy definition to delete., managementGroupId: any # The ID of the management group.}\n@returns(200) OK\n@returns(204) No Content\n\n@endpoint GET /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}\n@desc Retrieve a policy definition in a management group.\n@required {policyDefinitionName: any # The name of the policy definition to get., managementGroupId: any # The ID of the management group.}\n@returns(200) OK - Returns information about the policy definition.\n\n@endgroup\n\n@group subscriptions\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions\n@desc Retrieves policy definitions in a subscription\n@required {subscriptionId: any # The ID of the target subscription.}\n@returns(200) OK - Returns an array of policy definitions.\n\n@endgroup\n\n@group providers\n@endpoint GET /providers/Microsoft.Authorization/policyDefinitions\n@desc Retrieve built-in policy definitions\n@returns(200) OK - Returns an array of built-in policy definitions.\n\n@endpoint GET /providers/Microsoft.Management/managementgroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions\n@desc Retrieve policy definitions in a management group\n@required {managementGroupId: any # The ID of the management group.}\n@returns(200) OK - Returns an array of policy definitions.\n\n@endgroup\n\n@end\n"}}