MS AD discovery tasks

MS AD discovery tasks API overview

The MS AD discovery tasks API allows integrators to create, start, update, list, and delete Microsoft Active Directory (AD) scan tasks in SCM.
These tasks define discovery jobs that query AD for certificates or certificate-related objects.


MS AD discovery tasks API endpoints

The following table lists the endpoints for managing MS AD discovery scan tasks.
Click any action in the first column to open its API reference page.

ActionMethodPathDescription
Get a MS AD scan task listGET/api/discovery/v4/ad_taskRetrieve a list of all MS AD discovery scan tasks.
Add a MS AD scan taskPOST/api/discovery/v4/ad_taskCreate a new MS AD discovery scan task.
Start a MS AD scan taskPOST/api/discovery/v4/ad_task/{taskId}/startStart a previously created MS AD scan task.
Get a MS AD scan taskGET/api/discovery/v4/ad_task/{taskId}Retrieve configuration and status for a specific MS AD scan task.
Update a MS AD scan taskPUT/api/discovery/v4/ad_task/{id}Update an existing MS AD discovery scan task.
Delete a MS AD scan taskDELETE/api/discovery/v4/ad_task/{taskId}Delete a MS AD discovery scan task.