{"files":{"SKILL.md":"---\nname: microsoft-defender-for-cloud\ndescription: \"Microsoft Defender for Cloud API skill. Use when working with Microsoft Defender for Cloud for subscriptions. Covers 7 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Microsoft Defender for Cloud\nAPI version: 2015-06-01-preview\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://management.azure.com\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /subscriptions/{subscriptionId}/providers/Microsoft.Security/tasks -- recommended tasks that will help improve the security of the subscription proactively\n3. POST /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}/{taskUpdateActionType} -- create first task\n\n## Endpoints\n7 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Subscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.Security/tasks | Recommended tasks that will help improve the security of the subscription proactively |\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks | Recommended tasks that will help improve the security of the subscription proactively |\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName} | Recommended tasks that will help improve the security of the subscription proactively |\n| POST | /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}/{taskUpdateActionType} | Recommended tasks that will help improve the security of the subscription proactively |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/tasks | Recommended tasks that will help improve the security of the subscription proactively |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName} | Recommended tasks that will help improve the security of the subscription proactively |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}/{taskUpdateActionType} | Recommended tasks that will help improve the security of the subscription proactively |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all tasks?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.Security/tasks\n- \"Get task details?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}\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 Microsoft Defender for Cloud\n@base https://management.azure.com\n@version 2015-06-01-preview\n@auth OAuth2\n@endpoints 7\n@toc subscriptions(7)\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.Security/tasks\n@desc Recommended tasks that will help improve the security of the subscription proactively\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks\n@desc Recommended tasks that will help improve the security of the subscription proactively\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}\n@desc Recommended tasks that will help improve the security of the subscription proactively\n@required {taskName: any # Name of the task object, will be a GUID}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}/{taskUpdateActionType}\n@desc Recommended tasks that will help improve the security of the subscription proactively\n@required {taskName: any # Name of the task object, will be a GUID, taskUpdateActionType: any # Type of the action to do on the task}\n@returns(204) No Content\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/tasks\n@desc Recommended tasks that will help improve the security of the subscription proactively\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}\n@desc Recommended tasks that will help improve the security of the subscription proactively\n@required {taskName: any # Name of the task object, will be a GUID}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/tasks/{taskName}/{taskUpdateActionType}\n@desc Recommended tasks that will help improve the security of the subscription proactively\n@required {taskName: any # Name of the task object, will be a GUID, taskUpdateActionType: any # Type of the action to do on the task}\n@returns(204) No Content\n\n@end\n"}}