From 68b1687c990e51c7a7c03ab02aefcb7dfdcd1acd Mon Sep 17 00:00:00 2001 From: Dan Piazza <220388267+DanPiazza-Netwrix@users.noreply.github.com> Date: Thu, 14 May 2026 16:06:19 -0400 Subject: [PATCH 1/2] docs(changetracker): shorten all OpenAPI summaries to six words or fewer Shortens every summary field in the Change Tracker Hub OpenAPI spec to six words or fewer so that API reference page headers are concise. Detail from verbose summaries has been preserved in description fields. Generated with AI Co-Authored-By: Claude Code --- static/openapi/changetracker-hub-8.1.yaml | 790 +++++++++++----------- 1 file changed, 395 insertions(+), 395 deletions(-) diff --git a/static/openapi/changetracker-hub-8.1.yaml b/static/openapi/changetracker-hub-8.1.yaml index 5734bcbee5..3541efe262 100644 --- a/static/openapi/changetracker-hub-8.1.yaml +++ b/static/openapi/changetracker-hub-8.1.yaml @@ -9,7 +9,7 @@ paths: get: tags: - command - summary: 'Called by the agent, this returns a list of AgentTasks and latest tracking template definition dates for all the devices the agent manages.' + summary: 'Poll agent tasks and template dates' description: 'Called by the agent, this returns a list of AgentTasks and latest tracking template definition dates for all the devices the agent manages.' operationId: GetAgentPolltaskspollAgentId_Get parameters: @@ -118,7 +118,7 @@ paths: post: tags: - command - summary: 'Called by the agent, this returns a list of AgentTasks and latest tracking template definition dates for all the devices the agent manages.' + summary: 'Poll agent tasks and template dates' description: 'Called by the agent, this returns a list of AgentTasks and latest tracking template definition dates for all the devices the agent manages.' operationId: GetAgentPolltaskspollAgentId_Post requestBody: @@ -142,7 +142,7 @@ paths: get: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentAgentId_Get parameters: @@ -257,7 +257,7 @@ paths: post: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentAgentId_Post requestBody: @@ -281,7 +281,7 @@ paths: post: tags: - submitAgentTaskResultStream - summary: Used to submit agent task result data to the hub as a stream. + summary: Stream agent task result data description: Used to submit agent task result data to the hub as a stream. operationId: SubmitAgentTaskResultStreamAgentIdDeviceIdTaskId_Post requestBody: @@ -305,7 +305,7 @@ paths: get: tags: - submitAgentTaskResultData - summary: 'Adds report result data for the given agent report, called by the agent. This is the new format used by the Gen 7 agent.' + summary: 'Submit Gen 7 agent task data' description: 'Adds report result data for the given agent report, called by the agent. This is the new format used by the Gen 7 agent.' operationId: SubmitAgentTaskResultData_Get parameters: @@ -364,7 +364,7 @@ paths: post: tags: - submitAgentTaskResultData - summary: 'Adds report result data for the given agent report, called by the agent. This is the new format used by the Gen 7 agent.' + summary: 'Submit Gen 7 agent task data' description: 'Adds report result data for the given agent report, called by the agent. This is the new format used by the Gen 7 agent.' operationId: SubmitAgentTaskResultData_Post requestBody: @@ -386,7 +386,7 @@ paths: get: tags: - submitAgentTaskResult - summary: 'Adds task result data for the given agent task, called by the agent.' + summary: 'Submit agent task result' description: 'Adds task result data for the given agent task, called by the agent.' operationId: SubmitAgentTaskResult_Get parameters: @@ -474,7 +474,7 @@ paths: post: tags: - submitAgentTaskResult - summary: 'Adds task result data for the given agent task, called by the agent.' + summary: 'Submit agent task result' description: 'Adds task result data for the given agent task, called by the agent.' operationId: SubmitAgentTaskResult_Post requestBody: @@ -496,7 +496,7 @@ paths: get: tags: - credential - summary: Get specific credentials for requested type and key (name). + summary: Get credentials by type and key description: Get specific credentials for requested type and key (name). operationId: GetCredentials_Get parameters: @@ -539,7 +539,7 @@ paths: post: tags: - credential - summary: Get specific credentials for requested type and key (name). + summary: Get credentials by type and key description: Get specific credentials for requested type and key (name). operationId: GetCredentials_Post requestBody: @@ -736,7 +736,7 @@ paths: get: tags: - policyTemplateVariables - summary: A request to get a list of variable definitions from a named report to be collected by the agent. + summary: Get report variable definitions description: A request to get a list of variable definitions from a named report to be collected by the agent. operationId: GetPolicyTemplateVariables_Get parameters: @@ -770,7 +770,7 @@ paths: post: tags: - policyTemplateVariables - summary: A request to get a list of variable definitions from a named report to be collected by the agent. + summary: Get report variable definitions description: A request to get a list of variable definitions from a named report to be collected by the agent. operationId: GetPolicyTemplateVariables_Post requestBody: @@ -794,7 +794,7 @@ paths: get: tags: - deviceCredentials - summary: A request to get the names of credentials associated with an agent. + summary: Get agent credential names description: A request to get the names of credentials associated with an agent. operationId: GetCredentialsForAgentDevice_Get parameters: @@ -825,7 +825,7 @@ paths: post: tags: - deviceCredentials - summary: A request to get the names of credentials associated with an agent. + summary: Get agent credential names description: A request to get the names of credentials associated with an agent. operationId: GetCredentialsForAgentDevice_Post requestBody: @@ -852,7 +852,7 @@ paths: get: tags: - deviceDbCredentials - summary: A request to get the database credentials associated with a database proxied agent. + summary: Get proxied agent database credentials description: A request to get the database credentials associated with a database proxied agent. operationId: GetDbCredentialForDatabaseAgentDevice_Get parameters: @@ -880,7 +880,7 @@ paths: post: tags: - deviceDbCredentials - summary: A request to get the database credentials associated with a database proxied agent. + summary: Get proxied agent database credentials description: A request to get the database credentials associated with a database proxied agent. operationId: GetDbCredentialForDatabaseAgentDevice_Post requestBody: @@ -904,7 +904,7 @@ paths: get: tags: - groupMemberships - summary: 'A request to return groups this agent or group is a member of, including parents of parents etc.' + summary: 'Get agent or group memberships' description: 'A request to return groups this agent or group is a member of, including parents of parents etc.' operationId: GroupMemberships_Get parameters: @@ -951,7 +951,7 @@ paths: post: tags: - groupMemberships - summary: 'A request to return groups this agent or group is a member of, including parents of parents etc.' + summary: 'Get agent or group memberships' description: 'A request to return groups this agent or group is a member of, including parents of parents etc.' operationId: GroupMemberships_Post requestBody: @@ -978,7 +978,7 @@ paths: get: tags: - agents - summary: A request to return agents matching the device filter. + summary: List agents by device filter description: A request to return agents matching the device filter. operationId: GetAgents_Get parameters: @@ -1088,7 +1088,7 @@ paths: post: tags: - agents - summary: A request to return agents matching the device filter. + summary: List agents by device filter description: A request to return agents matching the device filter. operationId: GetAgents_Post requestBody: @@ -1112,7 +1112,7 @@ paths: get: tags: - agents - summary: Registers the details of an Agent with the system. + summary: Register agent details description: Registers the details of an Agent with the system. operationId: RegisterAgentregister_Get parameters: @@ -1267,7 +1267,7 @@ paths: post: tags: - agents - summary: Registers the details of an Agent with the system. + summary: Register agent details description: Registers the details of an Agent with the system. operationId: RegisterAgentregister_Post requestBody: @@ -1439,7 +1439,7 @@ paths: get: tags: - agents - summary: A request to find agents matching the device filter and search criteria. + summary: Find agents by filter and criteria description: A request to find agents matching the device filter and search criteria. operationId: SearchAgentssearch_Get parameters: @@ -1512,7 +1512,7 @@ paths: post: tags: - agents - summary: A request to find agents matching the device filter and search criteria. + summary: Find agents by filter and criteria description: A request to find agents matching the device filter and search criteria. operationId: SearchAgentssearch_Post requestBody: @@ -1536,7 +1536,7 @@ paths: get: tags: - agents - summary: Registers the details of the specified Agents with the system. + summary: Register specified agents description: Registers the details of the specified Agents with the system. operationId: PreRegisterAgentspreRegister_Get parameters: @@ -1567,7 +1567,7 @@ paths: post: tags: - agents - summary: Registers the details of the specified Agents with the system. + summary: Register specified agents description: Registers the details of the specified Agents with the system. operationId: PreRegisterAgentspreRegister_Post requestBody: @@ -1591,7 +1591,7 @@ paths: get: tags: - deviceConfig - summary: Get the tracking configuration template from the merged result of the group configurations for the groups the device is in. + summary: Get merged device tracking config description: Get the tracking configuration template from the merged result of the group configurations for the groups the device is in. operationId: GetDeviceConfig_Get parameters: @@ -1636,7 +1636,7 @@ paths: post: tags: - deviceConfig - summary: Get the tracking configuration template from the merged result of the group configurations for the groups the device is in. + summary: Get merged device tracking config description: Get the tracking configuration template from the merged result of the group configurations for the groups the device is in. operationId: GetDeviceConfig_Post requestBody: @@ -1660,7 +1660,7 @@ paths: get: tags: - deviceSettings - summary: 'Gets the device settings for the device or group, based on the global device settings and any group specific overrides.' + summary: 'Get device or group settings' description: 'Gets the device settings for the device or group, based on the global device settings and any group specific overrides.' operationId: GetDeviceSettings_Get parameters: @@ -1698,7 +1698,7 @@ paths: post: tags: - deviceSettings - summary: 'Gets the device settings for the device or group, based on the global device settings and any group specific overrides.' + summary: 'Get device or group settings' description: 'Gets the device settings for the device or group, based on the global device settings and any group specific overrides.' operationId: GetDeviceSettings_Post requestBody: @@ -1722,7 +1722,7 @@ paths: get: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEvents_Get parameters: @@ -1899,7 +1899,7 @@ paths: post: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEvents_Post requestBody: @@ -1923,7 +1923,7 @@ paths: get: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsstartStartUtc_Get parameters: @@ -2100,7 +2100,7 @@ paths: post: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsstartStartUtc_Post requestBody: @@ -2124,7 +2124,7 @@ paths: get: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsendEnd_Get parameters: @@ -2301,7 +2301,7 @@ paths: post: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsendEnd_Post requestBody: @@ -2325,7 +2325,7 @@ paths: get: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsstartStartUtcendEnd_Get parameters: @@ -2502,7 +2502,7 @@ paths: post: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsstartStartUtcendEnd_Post requestBody: @@ -2526,7 +2526,7 @@ paths: get: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsskipSkiptakeTake_Get parameters: @@ -2703,7 +2703,7 @@ paths: post: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsskipSkiptakeTake_Post requestBody: @@ -2727,7 +2727,7 @@ paths: get: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsEventId_Get parameters: @@ -2904,7 +2904,7 @@ paths: post: tags: - events - summary: Retrieves a list of events from the hub service. + summary: Retrieve events from hub description: Retrieves a list of events from the hub service. operationId: GetEventsEventId_Post requestBody: @@ -2928,7 +2928,7 @@ paths: get: tags: - alertEvents - summary: Adds a list of alert events to the system. + summary: Submit alert events description: Adds a list of alert events to the system. operationId: SubmitAlertEventsadd_Get parameters: @@ -2957,7 +2957,7 @@ paths: post: tags: - alertEvents - summary: Adds a list of alert events to the system. + summary: Submit alert events description: Adds a list of alert events to the system. operationId: SubmitAlertEventsadd_Post requestBody: @@ -2979,7 +2979,7 @@ paths: get: tags: - alertEvents - summary: Adds a list of alert events to the system. The response can indicate a rate-limiting back off time. + summary: Submit alert events with rate limiting description: Adds a list of alert events to the system. The response can indicate a rate-limiting back off time. operationId: SubmitAlertEventsLimitedlimitedAdd_Get parameters: @@ -3010,7 +3010,7 @@ paths: post: tags: - alertEvents - summary: Adds a list of alert events to the system. The response can indicate a rate-limiting back off time. + summary: Submit alert events with rate limiting description: Adds a list of alert events to the system. The response can indicate a rate-limiting back off time. operationId: SubmitAlertEventsLimitedlimitedAdd_Post requestBody: @@ -3034,7 +3034,7 @@ paths: get: tags: - baselineEvents - summary: Adds a list of baseline events to the system. + summary: Submit baseline events description: Adds a list of baseline events to the system. operationId: SubmitBaselineEventsadd_Get parameters: @@ -3063,7 +3063,7 @@ paths: post: tags: - baselineEvents - summary: Adds a list of baseline events to the system. + summary: Submit baseline events description: Adds a list of baseline events to the system. operationId: SubmitBaselineEventsadd_Post requestBody: @@ -3085,7 +3085,7 @@ paths: get: tags: - baselineEvents - summary: Adds a list of baseline events to the system. The response can indicate a rate-limiting back off time. + summary: Submit baseline events with rate limiting description: Adds a list of baseline events to the system. The response can indicate a rate-limiting back off time. operationId: SubmitBaselineEventsLimitedlimitedAdd_Get parameters: @@ -3116,7 +3116,7 @@ paths: post: tags: - baselineEvents - summary: Adds a list of baseline events to the system. The response can indicate a rate-limiting back off time. + summary: Submit baseline events with rate limiting description: Adds a list of baseline events to the system. The response can indicate a rate-limiting back off time. operationId: SubmitBaselineEventsLimitedlimitedAdd_Post requestBody: @@ -3140,7 +3140,7 @@ paths: get: tags: - deviceEvents - summary: Adds a list of device change events to the system. + summary: Submit device change events description: Adds a list of device change events to the system. operationId: SubmitDeviceEventsadd_Get parameters: @@ -3169,7 +3169,7 @@ paths: post: tags: - deviceEvents - summary: Adds a list of device change events to the system. + summary: Submit device change events description: Adds a list of device change events to the system. operationId: SubmitDeviceEventsadd_Post requestBody: @@ -3191,7 +3191,7 @@ paths: get: tags: - deviceEvents - summary: Adds a list of device change events to the system. The response can indicate a rate-limiting back off time. + summary: Submit device change events with rate limiting description: Adds a list of device change events to the system. The response can indicate a rate-limiting back off time. operationId: SubmitDeviceEventsLimitedlimitedAdd_Get parameters: @@ -3222,7 +3222,7 @@ paths: post: tags: - deviceEvents - summary: Adds a list of device change events to the system. The response can indicate a rate-limiting back off time. + summary: Submit device change events with rate limiting description: Adds a list of device change events to the system. The response can indicate a rate-limiting back off time. operationId: SubmitDeviceEventsLimitedlimitedAdd_Post requestBody: @@ -3246,7 +3246,7 @@ paths: get: tags: - status - summary: Gets whether system is booted and ready for login. + summary: Get system boot status description: Gets whether system is booted and ready for login. operationId: SystemReadyready_Get parameters: @@ -3267,7 +3267,7 @@ paths: post: tags: - status - summary: Gets whether system is booted and ready for login. + summary: Get system boot status description: Gets whether system is booted and ready for login. operationId: SystemReadyready_Post requestBody: @@ -3289,7 +3289,7 @@ paths: get: tags: - status - summary: Gets system version and config settings once logged in. + summary: Get system version and config description: Gets system version and config settings once logged in. operationId: SystemDetailssystem_Get parameters: @@ -3312,7 +3312,7 @@ paths: post: tags: - status - summary: Gets system version and config settings once logged in. + summary: Get system version and config description: Gets system version and config settings once logged in. operationId: SystemDetailssystem_Post requestBody: @@ -3336,7 +3336,7 @@ paths: get: tags: - status - summary: 'Retrieves a list of background, potentially long-running, tasks the hub has performed and their associated status.' + summary: 'List background task statuses' description: 'Retrieves a list of background, potentially long-running, tasks the hub has performed and their associated status.' operationId: GetBackgroundTaskStatusesbackgroundtasks_Get parameters: @@ -3410,7 +3410,7 @@ paths: post: tags: - status - summary: 'Retrieves a list of background, potentially long-running, tasks the hub has performed and their associated status.' + summary: 'List background task statuses' description: 'Retrieves a list of background, potentially long-running, tasks the hub has performed and their associated status.' operationId: GetBackgroundTaskStatusesbackgroundtasks_Post requestBody: @@ -3437,7 +3437,7 @@ paths: get: tags: - status - summary: Gets the number of events currently in the processing queue. + summary: Events in processing queue description: Gets the number of events currently in the processing queue. operationId: EventsOnIncomingQueueeventsOnIncomingQueue_Get parameters: @@ -3462,7 +3462,7 @@ paths: post: tags: - status - summary: Gets the number of events currently in the processing queue. + summary: Events in processing queue description: Gets the number of events currently in the processing queue. operationId: EventsOnIncomingQueueeventsOnIncomingQueue_Post requestBody: @@ -3488,7 +3488,7 @@ paths: get: tags: - status - summary: 'Returns the number of internal event notification messages received, processed or failed.' + summary: 'Count internal event notifications' description: 'Returns the number of internal event notification messages received, processed or failed.' operationId: EventMessageStatusmessageStatus_Get parameters: @@ -3515,7 +3515,7 @@ paths: post: tags: - status - summary: 'Returns the number of internal event notification messages received, processed or failed.' + summary: 'Count internal event notifications' description: 'Returns the number of internal event notification messages received, processed or failed.' operationId: EventMessageStatusmessageStatus_Post requestBody: @@ -3543,7 +3543,7 @@ paths: get: tags: - status - summary: 'Gets the pipeline status, returning a dictionary of pipeline components and their current status.' + summary: 'Get pipeline component statuses' description: 'Gets the pipeline status, returning a dictionary of pipeline components and their current status.' operationId: GetPipelineStatuspipeline_Get parameters: @@ -3579,7 +3579,7 @@ paths: post: tags: - status - summary: 'Gets the pipeline status, returning a dictionary of pipeline components and their current status.' + summary: 'Get pipeline component statuses' description: 'Gets the pipeline status, returning a dictionary of pipeline components and their current status.' operationId: GetPipelineStatuspipeline_Post requestBody: @@ -4048,7 +4048,7 @@ paths: get: tags: - reports - summary: Deletes a report layout template of the specified type and name + summary: Delete report layout template description: Deletes a report layout template of the specified type and name operationId: DeleteCustomReportTemplatedeletecustomreporttemplate_Get parameters: @@ -4100,7 +4100,7 @@ paths: post: tags: - reports - summary: Deletes a report layout template of the specified type and name + summary: Delete report layout template description: Deletes a report layout template of the specified type and name operationId: DeleteCustomReportTemplatedeletecustomreporttemplate_Post requestBody: @@ -4122,7 +4122,7 @@ paths: get: tags: - reports - summary: A request to gets the data for a device monitoring report + summary: Get device monitoring report data description: A request to gets the data for a device monitoring report operationId: DataSpecDeviceMonitoringReportdevicemonitoring_Get parameters: @@ -4201,7 +4201,7 @@ paths: post: tags: - reports - summary: A request to gets the data for a device monitoring report + summary: Get device monitoring report data description: A request to gets the data for a device monitoring report operationId: DataSpecDeviceMonitoringReportdevicemonitoring_Post requestBody: @@ -4410,7 +4410,7 @@ paths: get: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedata_Get parameters: @@ -4479,7 +4479,7 @@ paths: post: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedata_Post requestBody: @@ -4503,7 +4503,7 @@ paths: get: tags: - stats - summary: Get a list of groups or devices that have report data available for them + summary: List groups with available report data description: Get a list of groups or devices that have report data available for them operationId: GetAvailableComplianceDatagetavailablecompliancedata_Get parameters: @@ -4526,7 +4526,7 @@ paths: post: tags: - stats - summary: Get a list of groups or devices that have report data available for them + summary: List groups with available report data description: Get a list of groups or devices that have report data available for them operationId: GetAvailableComplianceDatagetavailablecompliancedata_Post requestBody: @@ -4550,7 +4550,7 @@ paths: get: tags: - stats - summary: Gets a list of inactive devices matching the filter. + summary: List inactive devices by filter description: Gets a list of inactive devices matching the filter. operationId: GetDeviceActivitydeviceActivity_Get parameters: @@ -4573,7 +4573,7 @@ paths: post: tags: - stats - summary: Gets a list of inactive devices matching the filter. + summary: List inactive devices by filter description: Gets a list of inactive devices matching the filter. operationId: GetDeviceActivitydeviceActivity_Post requestBody: @@ -4597,7 +4597,7 @@ paths: get: tags: - stats - summary: 'Gets a summary of event counts for the devices or groups specified by the DeviceFilter, for the specified time period.' + summary: 'Get event counts by device filter' description: 'Gets a summary of event counts for the devices or groups specified by the DeviceFilter, for the specified time period.' operationId: GetEventCountsevents_Get parameters: @@ -4660,7 +4660,7 @@ paths: post: tags: - stats - summary: 'Gets a summary of event counts for the devices or groups specified by the DeviceFilter, for the specified time period.' + summary: 'Get event counts by device filter' description: 'Gets a summary of event counts for the devices or groups specified by the DeviceFilter, for the specified time period.' operationId: GetEventCountsevents_Post requestBody: @@ -4684,7 +4684,7 @@ paths: get: tags: - stats - summary: 'Gets a summary of event counts for top N noisiest devices in the specified group, for the specified time period.' + summary: 'Get noisy device event counts' description: 'Gets a summary of event counts for top N noisiest devices in the specified group, for the specified time period.' operationId: GetNoisyDevicesnoisydevices_Get parameters: @@ -4709,7 +4709,7 @@ paths: post: tags: - stats - summary: 'Gets a summary of event counts for top N noisiest devices in the specified group, for the specified time period.' + summary: 'Get noisy device event counts' description: 'Gets a summary of event counts for top N noisiest devices in the specified group, for the specified time period.' operationId: GetNoisyDevicesnoisydevices_Post parameters: @@ -4992,7 +4992,7 @@ paths: get: tags: - reports - summary: Gets a previously generated report output file + summary: Get generated report output file description: Gets a previously generated report output file operationId: GetScheduledInstanceOutputscheduledinstancesrendereddownload_Get parameters: @@ -5016,7 +5016,7 @@ paths: post: tags: - reports - summary: Gets a previously generated report output file + summary: Get generated report output file description: Gets a previously generated report output file operationId: GetScheduledInstanceOutputscheduledinstancesrendereddownload_Post requestBody: @@ -5250,7 +5250,7 @@ paths: get: tags: - reports - summary: Adds a new schedulable report of the type specified by the Id parameter + summary: Add scheduled report description: Adds a new schedulable report of the type specified by the Id parameter operationId: AddScheduledReportscheduledadd_Get parameters: @@ -5302,7 +5302,7 @@ paths: post: tags: - reports - summary: Adds a new schedulable report of the type specified by the Id parameter + summary: Add scheduled report description: Adds a new schedulable report of the type specified by the Id parameter operationId: AddScheduledReportscheduledadd_Post requestBody: @@ -5608,7 +5608,7 @@ paths: get: tags: - updatehubdetails - summary: Update the HUbDetails.xml file for the specified agents / groups + summary: Update HubDetails.xml for agents/groups description: Update the HUbDetails.xml file for the specified agents / groups operationId: UpdateHubDetails_Get parameters: @@ -5629,7 +5629,7 @@ paths: post: tags: - updatehubdetails - summary: Update the HUbDetails.xml file for the specified agents / groups + summary: Update HubDetails.xml for agents/groups description: Update the HUbDetails.xml file for the specified agents / groups operationId: UpdateHubDetails_Post requestBody: @@ -5651,7 +5651,7 @@ paths: get: tags: - downloadAgentUpdate - summary: Download an update package for the agent. + summary: Download agent update package description: Download an update package for the agent. operationId: DownloadUpdateVersionRequested_Get parameters: @@ -5702,7 +5702,7 @@ paths: post: tags: - downloadAgentUpdate - summary: Download an update package for the agent. + summary: Download agent update package description: Download an update package for the agent. operationId: DownloadUpdateVersionRequested_Post requestBody: @@ -5726,7 +5726,7 @@ paths: get: tags: - downloadAgentUpdate - summary: Download an update package for the agent. + summary: Download agent update package description: Download an update package for the agent. operationId: DownloadUpdateVersionRequestedUpdateType_Get parameters: @@ -5777,7 +5777,7 @@ paths: post: tags: - downloadAgentUpdate - summary: Download an update package for the agent. + summary: Download agent update package description: Download an update package for the agent. operationId: DownloadUpdateVersionRequestedUpdateType_Post requestBody: @@ -5849,7 +5849,7 @@ paths: get: tags: - agentUpdates - summary: 'Gets a list of Agent updates, by version or specific ID.' + summary: 'List agent updates' description: 'Gets a list of Agent updates, by version or specific ID.' operationId: GetAgentUpdates_Get parameters: @@ -5908,7 +5908,7 @@ paths: post: tags: - agentUpdates - summary: 'Gets a list of Agent updates, by version or specific ID.' + summary: 'List agent updates' description: 'Gets a list of Agent updates, by version or specific ID.' operationId: GetAgentUpdates_Post requestBody: @@ -5935,7 +5935,7 @@ paths: get: tags: - agentSoftwareUpdateSchedules - summary: Gets the agent software update schedule for a group. + summary: Get group agent update schedule description: Gets the agent software update schedule for a group. operationId: GetAgentSoftwareUpdateScheduleForGroup_Get parameters: @@ -5966,7 +5966,7 @@ paths: post: tags: - agentSoftwareUpdateSchedules - summary: Gets the agent software update schedule for a group. + summary: Get group agent update schedule description: Gets the agent software update schedule for a group. operationId: GetAgentSoftwareUpdateScheduleForGroup_Post requestBody: @@ -5993,7 +5993,7 @@ paths: get: tags: - agentSoftwareUpdateSchedules - summary: Remove (delete) the agent software update schedule for a group. + summary: Remove group agent update schedule description: Remove (delete) the agent software update schedule for a group. operationId: DeleteAgentSoftwareUpdateScheduleFromGroupdelete_Get parameters: @@ -6019,7 +6019,7 @@ paths: post: tags: - agentSoftwareUpdateSchedules - summary: Remove (delete) the agent software update schedule for a group. + summary: Remove group agent update schedule description: Remove (delete) the agent software update schedule for a group. operationId: DeleteAgentSoftwareUpdateScheduleFromGroupdelete_Post requestBody: @@ -6041,7 +6041,7 @@ paths: get: tags: - agentSoftwareUpdateSchedules - summary: Update the agent software update schedule for a group. + summary: Update group agent update schedule description: Update the agent software update schedule for a group. operationId: UpdateAgentSoftwareUpdateScheduleForGroupupdate_Get parameters: @@ -6072,7 +6072,7 @@ paths: post: tags: - agentSoftwareUpdateSchedules - summary: Update the agent software update schedule for a group. + summary: Update group agent update schedule description: Update the agent software update schedule for a group. operationId: UpdateAgentSoftwareUpdateScheduleForGroupupdate_Post requestBody: @@ -6094,7 +6094,7 @@ paths: get: tags: - agentSoftwareUpdateSchedules - summary: Add (set) an agent update schedule for a specific group. Only one schedule is permitted per group at the current time. + summary: Set agent update schedule for group description: Add (set) an agent update schedule for a specific group. Only one schedule is permitted per group at the current time. operationId: SetAgentSoftwareUpdateScheduleForGroupadd_Get parameters: @@ -6130,7 +6130,7 @@ paths: post: tags: - agentSoftwareUpdateSchedules - summary: Add (set) an agent update schedule for a specific group. Only one schedule is permitted per group at the current time. + summary: Set agent update schedule for group description: Add (set) an agent update schedule for a specific group. Only one schedule is permitted per group at the current time. operationId: SetAgentSoftwareUpdateScheduleForGroupadd_Post requestBody: @@ -6157,7 +6157,7 @@ paths: get: tags: - syncServiceConfigItems - summary: Retrieves a list of SyncService configuration items. + summary: List SyncService configuration items description: Retrieves a list of SyncService configuration items. operationId: GetSyncServiceConfigItems_Get parameters: @@ -6220,7 +6220,7 @@ paths: post: tags: - syncServiceConfigItems - summary: Retrieves a list of SyncService configuration items. + summary: List SyncService configuration items description: Retrieves a list of SyncService configuration items. operationId: GetSyncServiceConfigItems_Post requestBody: @@ -6316,7 +6316,7 @@ paths: get: tags: - configItems - summary: Retrieves a list of hub configuration parameters. + summary: List hub configuration parameters description: Retrieves a list of hub configuration parameters. operationId: GetConfigItems_Get parameters: @@ -6403,7 +6403,7 @@ paths: post: tags: - configItems - summary: Retrieves a list of hub configuration parameters. + summary: List hub configuration parameters description: Retrieves a list of hub configuration parameters. operationId: GetConfigItems_Post requestBody: @@ -6427,7 +6427,7 @@ paths: get: tags: - configItems - summary: Add a list of hub configuration parameters. + summary: Add hub config parameters description: Add a list of hub configuration parameters. operationId: AddConfigItemsadd_Get parameters: @@ -6463,7 +6463,7 @@ paths: post: tags: - configItems - summary: Add a list of hub configuration parameters. + summary: Add hub config parameters description: Add a list of hub configuration parameters. operationId: AddConfigItemsadd_Post requestBody: @@ -6491,7 +6491,7 @@ paths: get: tags: - configItems - summary: Update a a list of hub configuration parameters. + summary: Update hub config parameters description: Update a a list of hub configuration parameters. operationId: UpdateConfigItemsupdate_Get parameters: @@ -6520,7 +6520,7 @@ paths: post: tags: - configItems - summary: Update a a list of hub configuration parameters. + summary: Update hub config parameters description: Update a a list of hub configuration parameters. operationId: UpdateConfigItemsupdate_Post requestBody: @@ -6542,7 +6542,7 @@ paths: get: tags: - configItems - summary: Remove a hub configuration parameter by either ID or Key. + summary: Remove hub config by ID description: Remove a hub configuration parameter by either ID or Key. operationId: DeleteConfigItemdelete_Get parameters: @@ -6573,7 +6573,7 @@ paths: post: tags: - configItems - summary: Remove a hub configuration parameter by either ID or Key. + summary: Remove hub config by ID description: Remove a hub configuration parameter by either ID or Key. operationId: DeleteConfigItemdelete_Post requestBody: @@ -6595,7 +6595,7 @@ paths: get: tags: - configItem - summary: Update a single hub configuration parameter by either ID or Key. + summary: Update config by ID or key description: Update a single hub configuration parameter by either ID or Key. operationId: UpdateConfigItemupdate_Get parameters: @@ -6636,7 +6636,7 @@ paths: post: tags: - configItem - summary: Update a single hub configuration parameter by either ID or Key. + summary: Update config by ID or key description: Update a single hub configuration parameter by either ID or Key. operationId: UpdateConfigItemupdate_Post requestBody: @@ -6658,7 +6658,7 @@ paths: get: tags: - configItem - summary: Add a hub configuration parameter by Key. + summary: Add hub config by Key description: Add a hub configuration parameter by Key. operationId: AddConfigItemadd_Get parameters: @@ -6697,7 +6697,7 @@ paths: post: tags: - configItem - summary: Add a hub configuration parameter by Key. + summary: Add hub config by Key description: Add a hub configuration parameter by Key. operationId: AddConfigItemadd_Post requestBody: @@ -6721,7 +6721,7 @@ paths: get: tags: - misc - summary: Echos the specified date/time value to ensure that no serialization issues exist between hub and client. + summary: Echo date/time serialization test description: Echos the specified date/time value to ensure that no serialization issues exist between hub and client. operationId: DateTransmissionTestdateTransmissionTest_Get parameters: @@ -6753,7 +6753,7 @@ paths: post: tags: - misc - summary: Echos the specified date/time value to ensure that no serialization issues exist between hub and client. + summary: Echo date/time serialization test description: Echos the specified date/time value to ensure that no serialization issues exist between hub and client. operationId: DateTransmissionTestdateTransmissionTest_Post requestBody: @@ -6779,7 +6779,7 @@ paths: get: tags: - credentials - summary: Add credentials for specified type and key. + summary: Add credentials for type and key. description: Add credentials for specified type and key. operationId: AddCredentialsadd_Get parameters: @@ -6807,7 +6807,7 @@ paths: post: tags: - credentials - summary: Add credentials for specified type and key. + summary: Add credentials for type and key. description: Add credentials for specified type and key. operationId: AddCredentialsadd_Post requestBody: @@ -6831,7 +6831,7 @@ paths: get: tags: - credentials - summary: Update credentials for specified type and key. + summary: Update credentials by type and key. description: Update credentials for specified type and key. operationId: UpdateCredentialsupdate_Get parameters: @@ -6879,7 +6879,7 @@ paths: post: tags: - credentials - summary: Update credentials for specified type and key. + summary: Update credentials by type and key. description: Update credentials for specified type and key. operationId: UpdateCredentialsupdate_Post requestBody: @@ -6903,7 +6903,7 @@ paths: get: tags: - credentials - summary: Remove credentials for specified type and key. + summary: Remove credentials by type and key description: Remove credentials for specified type and key. operationId: RemoveCredentialsdelete_Get parameters: @@ -6944,7 +6944,7 @@ paths: post: tags: - credentials - summary: Remove credentials for specified type and key. + summary: Remove credentials by type and key description: Remove credentials for specified type and key. operationId: RemoveCredentialsdelete_Post requestBody: @@ -6966,7 +6966,7 @@ paths: get: tags: - credentialsKeyedByType - summary: 'Get a list of all the known credentials, keyed by the type.' + summary: 'List credentials by type' description: 'Get a list of all the known credentials, keyed by the type.' operationId: GetCredentialsKeyedByType_Get parameters: @@ -6995,7 +6995,7 @@ paths: post: tags: - credentialsKeyedByType - summary: 'Get a list of all the known credentials, keyed by the type.' + summary: 'List credentials by type' description: 'Get a list of all the known credentials, keyed by the type.' operationId: GetCredentialsKeyedByType_Post requestBody: @@ -7025,7 +7025,7 @@ paths: get: tags: - credentials - summary: Gets a list of all credentials of the specified type. + summary: List credentials of specified type description: Gets a list of all credentials of the specified type. operationId: GetCredentialsList_Get parameters: @@ -7071,7 +7071,7 @@ paths: post: tags: - credentials - summary: Gets a list of all credentials of the specified type. + summary: List credentials of specified type description: Gets a list of all credentials of the specified type. operationId: GetCredentialsList_Post requestBody: @@ -7098,7 +7098,7 @@ paths: get: tags: - command - summary: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + summary: 'Get task status' description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' operationId: GetAgentTaskStatusestasksstatus_Get parameters: @@ -7137,7 +7137,7 @@ paths: post: tags: - command - summary: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + summary: 'Get task status' description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' operationId: GetAgentTaskStatusestasksstatus_Post requestBody: @@ -7161,7 +7161,7 @@ paths: get: tags: - command - summary: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + summary: 'Get task status' description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' operationId: GetAgentTaskStatusestasksstatusidsIds_Get parameters: @@ -7200,7 +7200,7 @@ paths: post: tags: - command - summary: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + summary: 'Get task status' description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' operationId: GetAgentTaskStatusestasksstatusidsIds_Post requestBody: @@ -7224,7 +7224,7 @@ paths: get: tags: - command - summary: Adds a list of tasks for the given agent. + summary: Add agent tasks description: Adds a list of tasks for the given agent. operationId: SubmitAgentTaskstasksaddagentAgentId_Get parameters: @@ -7255,7 +7255,7 @@ paths: post: tags: - command - summary: Adds a list of tasks for the given agent. + summary: Add agent tasks description: Adds a list of tasks for the given agent. operationId: SubmitAgentTaskstasksaddagentAgentId_Post requestBody: @@ -7279,7 +7279,7 @@ paths: get: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentlegacyLegacyId_Get parameters: @@ -7394,7 +7394,7 @@ paths: post: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentlegacyLegacyId_Post requestBody: @@ -7418,7 +7418,7 @@ paths: get: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentAgentIdallAllTasks_Get parameters: @@ -7533,7 +7533,7 @@ paths: post: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentAgentIdallAllTasks_Post requestBody: @@ -7557,7 +7557,7 @@ paths: get: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentAgentIdsingleTaskId_Get parameters: @@ -7672,7 +7672,7 @@ paths: post: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentAgentIdsingleTaskId_Post requestBody: @@ -7696,7 +7696,7 @@ paths: get: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentlegacyLegacyIdallAllTasks_Get parameters: @@ -7811,7 +7811,7 @@ paths: post: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentlegacyLegacyIdallAllTasks_Post requestBody: @@ -7835,7 +7835,7 @@ paths: get: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentlegacyLegacyIdsingleTaskId_Get parameters: @@ -7950,7 +7950,7 @@ paths: post: tags: - command - summary: Requests information about tasks for the given agent. + summary: Get tasks for given agent description: Requests information about tasks for the given agent. operationId: GetAgentTaskstasksagentlegacyLegacyIdsingleTaskId_Post requestBody: @@ -7974,7 +7974,7 @@ paths: get: tags: - downloadFileHash - summary: Download the filehasing utility app for remote monitoring. + summary: Download file hashing utility description: Download the filehasing utility app for remote monitoring. operationId: DownloadFileHashBinaryHostTypeOperatingSystemVariant_Get parameters: @@ -8033,7 +8033,7 @@ paths: post: tags: - downloadFileHash - summary: Download the filehasing utility app for remote monitoring. + summary: Download file hashing utility description: Download the filehasing utility app for remote monitoring. operationId: DownloadFileHashBinaryHostTypeOperatingSystemVariant_Post requestBody: @@ -8057,7 +8057,7 @@ paths: get: tags: - downloadFileHashById - summary: Download the filehasing utility app for remote monitoring. + summary: Download file hashing utility description: Download the filehasing utility app for remote monitoring. operationId: DownloadFileHashBinaryFileId_Get parameters: @@ -8116,7 +8116,7 @@ paths: post: tags: - downloadFileHashById - summary: Download the filehasing utility app for remote monitoring. + summary: Download file hashing utility description: Download the filehasing utility app for remote monitoring. operationId: DownloadFileHashBinaryFileId_Post requestBody: @@ -8140,7 +8140,7 @@ paths: get: tags: - getFileHashBinaries - summary: Retrieves the list of file hash binaries available to download from the hub. + summary: List file hash binaries description: Retrieves the list of file hash binaries available to download from the hub. operationId: GetFileHashBinaries_Get parameters: @@ -8166,7 +8166,7 @@ paths: post: tags: - getFileHashBinaries - summary: Retrieves the list of file hash binaries available to download from the hub. + summary: List file hash binaries description: Retrieves the list of file hash binaries available to download from the hub. operationId: GetFileHashBinaries_Post requestBody: @@ -8193,7 +8193,7 @@ paths: get: tags: - plannedChangeInstances - summary: Gets the group and device members of the specified planned change instance. + summary: Get planned change instance members description: Gets the group and device members of the specified planned change instance. operationId: GetPlannedChangeInstanceMembersmembers_Get parameters: @@ -8222,7 +8222,7 @@ paths: post: tags: - plannedChangeInstances - summary: Gets the group and device members of the specified planned change instance. + summary: Get planned change instance members description: Gets the group and device members of the specified planned change instance. operationId: GetPlannedChangeInstanceMembersmembers_Post requestBody: @@ -8246,7 +8246,7 @@ paths: get: tags: - plannedChangeInstances - summary: Deletes an instance of a planned change from the system. + summary: Delete a planned change instance description: Deletes an instance of a planned change from the system. operationId: DeletePlannedChangeInstancedelete_Get parameters: @@ -8279,7 +8279,7 @@ paths: post: tags: - plannedChangeInstances - summary: Deletes an instance of a planned change from the system. + summary: Delete a planned change instance description: Deletes an instance of a planned change from the system. operationId: DeletePlannedChangeInstancedelete_Post requestBody: @@ -8301,7 +8301,7 @@ paths: get: tags: - plannedChangeInstances - summary: Removes a group or device from a planned change + summary: Remove member from planned change description: Removes a group or device from a planned change operationId: DeletePlannedChangeInstanceMemberdeleteMember_Get parameters: @@ -8338,7 +8338,7 @@ paths: post: tags: - plannedChangeInstances - summary: Removes a group or device from a planned change + summary: Remove member from planned change description: Removes a group or device from a planned change operationId: DeletePlannedChangeInstanceMemberdeleteMember_Post requestBody: @@ -8720,7 +8720,7 @@ paths: get: tags: - plannedChangeInstances - summary: 'Gets planned change instances name and id, filtering by name, id or groups that are members.' + summary: 'Get planned change instance names' description: 'Gets planned change instances name and id, filtering by name, id or groups that are members.' operationId: GetPlannedChangeInstancesNameValuenameValue_Get parameters: @@ -8856,7 +8856,7 @@ paths: post: tags: - plannedChangeInstances - summary: 'Gets planned change instances name and id, filtering by name, id or groups that are members.' + summary: 'Get planned change instance names' description: 'Gets planned change instances name and id, filtering by name, id or groups that are members.' operationId: GetPlannedChangeInstancesNameValuenameValue_Post requestBody: @@ -8880,7 +8880,7 @@ paths: get: tags: - plannedChangeInstances - summary: Add a list of groups to a planned change + summary: Add groups to a planned change description: Add a list of groups to a planned change operationId: AddPlannedChangeInstanceMemberaddMembers_Get parameters: @@ -8923,7 +8923,7 @@ paths: post: tags: - plannedChangeInstances - summary: Add a list of groups to a planned change + summary: Add groups to a planned change description: Add a list of groups to a planned change operationId: AddPlannedChangeInstanceMemberaddMembers_Post requestBody: @@ -8945,7 +8945,7 @@ paths: get: tags: - plannedChangeInstances - summary: A request to add a new planned change and planned change instance based on the given events. + summary: Add planned change from events description: A request to add a new planned change and planned change instance based on the given events. operationId: AddOrUpdatePlannedChangeInstanceFromEventsaddOrUpdateFromEvents_Get parameters: @@ -9049,7 +9049,7 @@ paths: post: tags: - plannedChangeInstances - summary: A request to add a new planned change and planned change instance based on the given events. + summary: Add planned change from events description: A request to add a new planned change and planned change instance based on the given events. operationId: AddOrUpdatePlannedChangeInstanceFromEventsaddOrUpdateFromEvents_Post requestBody: @@ -9073,7 +9073,7 @@ paths: get: tags: - plannedChangeInstances - summary: A request to re-evaluate the events associated with the specified planned change. + summary: Re-evaluate planned change instance events description: A request to re-evaluate the events associated with the specified planned change. operationId: AddReEvaluationOfPlannedChangeInstanceEventsreevaluateEvents_Get parameters: @@ -9117,7 +9117,7 @@ paths: post: tags: - plannedChangeInstances - summary: A request to re-evaluate the events associated with the specified planned change. + summary: Re-evaluate planned change instance events description: A request to re-evaluate the events associated with the specified planned change. operationId: AddReEvaluationOfPlannedChangeInstanceEventsreevaluateEvents_Post requestBody: @@ -9139,7 +9139,7 @@ paths: get: tags: - plannedChangeInstances - summary: 'Gets planned change instances, filtering by name, id or groups that are members.' + summary: 'Get planned change instances' description: 'Gets planned change instances, filtering by name, id or groups that are members.' operationId: GetPlannedChangeInstances_Get parameters: @@ -9281,7 +9281,7 @@ paths: post: tags: - plannedChangeInstances - summary: 'Gets planned change instances, filtering by name, id or groups that are members.' + summary: 'Get planned change instances' description: 'Gets planned change instances, filtering by name, id or groups that are members.' operationId: GetPlannedChangeInstances_Post requestBody: @@ -9635,7 +9635,7 @@ paths: get: tags: - plannedChanges - summary: 'Create rule reduction plans, which can be used to simplify rulesets associated with the specified planned change.' + summary: 'Create planned change rule reduction' description: 'Create rule reduction plans, which can be used to simplify rulesets associated with the specified planned change.' operationId: AnalyzePlannedChangeanalyze_Get parameters: @@ -9671,7 +9671,7 @@ paths: post: tags: - plannedChanges - summary: 'Create rule reduction plans, which can be used to simplify rulesets associated with the specified planned change.' + summary: 'Create planned change rule reduction' description: 'Create rule reduction plans, which can be used to simplify rulesets associated with the specified planned change.' operationId: AnalyzePlannedChangeanalyze_Post requestBody: @@ -9695,7 +9695,7 @@ paths: get: tags: - plannedChanges - summary: 'Apply rule reduction plans to the specified planned change, simplifying the associated rulesets.' + summary: 'Apply planned change rule reduction' description: 'Apply rule reduction plans to the specified planned change, simplifying the associated rulesets.' operationId: ApplyPlannedChangePlanapplyPlan_Get parameters: @@ -9734,7 +9734,7 @@ paths: post: tags: - plannedChanges - summary: 'Apply rule reduction plans to the specified planned change, simplifying the associated rulesets.' + summary: 'Apply planned change rule reduction' description: 'Apply rule reduction plans to the specified planned change, simplifying the associated rulesets.' operationId: ApplyPlannedChangePlanapplyPlan_Post requestBody: @@ -9756,7 +9756,7 @@ paths: get: tags: - plannedChanges - summary: Updates a rule in a planned change + summary: Update planned change rule description: Updates a rule in a planned change operationId: UpdatePlannedChangeRuleupdateRule_Get parameters: @@ -9777,7 +9777,7 @@ paths: post: tags: - plannedChanges - summary: Updates a rule in a planned change + summary: Update planned change rule description: Updates a rule in a planned change operationId: UpdatePlannedChangeRuleupdateRule_Post requestBody: @@ -9799,7 +9799,7 @@ paths: get: tags: - plannedChanges - summary: Updates the entire rule set in a planned change + summary: Update planned change rule set description: Updates the entire rule set in a planned change operationId: UpdatePlannedChangeRulesupdateRules_Get parameters: @@ -9837,7 +9837,7 @@ paths: post: tags: - plannedChanges - summary: Updates the entire rule set in a planned change + summary: Update planned change rule set description: Updates the entire rule set in a planned change operationId: UpdatePlannedChangeRulesupdateRules_Post requestBody: @@ -9862,7 +9862,7 @@ paths: get: tags: - plannedChanges - summary: Removes a rule from a planned change + summary: Remove rule from planned change. description: Removes a rule from a planned change operationId: DeletePlannedChangeRuledeleteRule_Get parameters: @@ -9893,7 +9893,7 @@ paths: post: tags: - plannedChanges - summary: Removes a rule from a planned change + summary: Remove rule from planned change. description: Removes a rule from a planned change operationId: DeletePlannedChangeRuledeleteRule_Post requestBody: @@ -9915,7 +9915,7 @@ paths: get: tags: - plannedChanges - summary: Delete a planned change ruleset definition from the system. + summary: Delete a planned change ruleset description: Delete a planned change ruleset definition from the system. operationId: DeletePlannedChangedelete_Get parameters: @@ -9941,7 +9941,7 @@ paths: post: tags: - plannedChanges - summary: Delete a planned change ruleset definition from the system. + summary: Delete a planned change ruleset description: Delete a planned change ruleset definition from the system. operationId: DeletePlannedChangedelete_Post requestBody: @@ -9963,7 +9963,7 @@ paths: get: tags: - plannedChangeRule - summary: Add a rule to a planned change + summary: Add rule to a planned change. description: Add a rule to a planned change operationId: AddPlannedChangeRuleadd_Get parameters: @@ -9996,7 +9996,7 @@ paths: post: tags: - plannedChangeRule - summary: Add a rule to a planned change + summary: Add rule to a planned change. description: Add a rule to a planned change operationId: AddPlannedChangeRuleadd_Post requestBody: @@ -10020,7 +10020,7 @@ paths: get: tags: - plannedChanges - summary: 'Gets a list of planned change ruleset definitions, filtered by name or id.' + summary: 'Get planned change ruleset definitions' description: 'Gets a list of planned change ruleset definitions, filtered by name or id.' operationId: GetPlannedChanges_Get parameters: @@ -10103,7 +10103,7 @@ paths: post: tags: - plannedChanges - summary: 'Gets a list of planned change ruleset definitions, filtered by name or id.' + summary: 'Get planned change ruleset definitions' description: 'Gets a list of planned change ruleset definitions, filtered by name or id.' operationId: GetPlannedChanges_Post requestBody: @@ -10127,7 +10127,7 @@ paths: get: tags: - commandParser - summary: 'Attempts to parse the supplied commandline, returning a list of disallowed command fragments on failure.' + summary: 'Parse command line' description: 'Attempts to parse the supplied commandline, returning a list of disallowed command fragments on failure.' operationId: ParseCommandsparse_Get parameters: @@ -10158,7 +10158,7 @@ paths: post: tags: - commandParser - summary: 'Attempts to parse the supplied commandline, returning a list of disallowed command fragments on failure.' + summary: 'Parse command line' description: 'Attempts to parse the supplied commandline, returning a list of disallowed command fragments on failure.' operationId: ParseCommandsparse_Post requestBody: @@ -10205,7 +10205,7 @@ paths: post: tags: - commandParser - summary: Attempts to whitelist the supplied command component. + summary: Whitelists a command component. description: Attempts to whitelist the supplied command component. operationId: CreateWhitelistedCommandComponentwhitelist_Post requestBody: @@ -10229,7 +10229,7 @@ paths: get: tags: - commandParser - summary: Attempts to get all the whitelisted command components. + summary: List whitelisted command components description: Attempts to get all the whitelisted command components. operationId: GetAllWhitelistedCommandComponentswhitelistall_Get parameters: @@ -10295,7 +10295,7 @@ paths: post: tags: - commandParser - summary: Attempts to update the supplied command component by id. + summary: Update command component by ID description: Attempts to update the supplied command component by id. operationId: UpdateWhitelistedCommandComponentwhitelistupdate_Post requestBody: @@ -10319,7 +10319,7 @@ paths: post: tags: - commandParser - summary: Attempts to bulk update the whitelisted command component with the supplied ids. + summary: Bulk update command components description: Attempts to bulk update the whitelisted command component with the supplied ids. operationId: UpdateWhitelistedCommandComponentswhitelistupdateMany_Post requestBody: @@ -10343,7 +10343,7 @@ paths: post: tags: - commandParser - summary: Adds the given template(s) to a command component. + summary: Add templates to command component description: Adds the given template(s) to a command component. operationId: AddTemplatesToCommandComponentcommandComponentaddTemplates_Post requestBody: @@ -10367,7 +10367,7 @@ paths: post: tags: - commandParser - summary: Attempts to remove the given template(s) from a command component. + summary: Remove templates from command component description: Attempts to remove the given template(s) from a command component. operationId: RemoveTemplatesFromCommandComponentcommandComponentremoveTemplates_Post requestBody: @@ -10391,7 +10391,7 @@ paths: get: tags: - commandParser - summary: Gets all templates of a command component. + summary: Get templates for command component description: Gets all templates of a command component. operationId: GetAllCommandComponentTemplatescommandComponenttemplates_Get parameters: @@ -10454,7 +10454,7 @@ paths: post: tags: - commandParser - summary: 'Attempts to set the given template(s) to a command component, clearing old templates if they exist.' + summary: 'Set command component templates' description: 'Attempts to set the given template(s) to a command component, clearing old templates if they exist.' operationId: SetAllTemplatesOfCommandComponentcommandComponenttemplates_Post requestBody: @@ -10478,7 +10478,7 @@ paths: post: tags: - commandParser - summary: Gets all templates of multiple command components. + summary: Get templates for command components description: Gets all templates of multiple command components. operationId: GetAllCommandComponentsTemplatescommandComponentManytemplates_Post requestBody: @@ -10502,7 +10502,7 @@ paths: get: tags: - cloudTemplate - summary: Provide a ProspectiveName for the Cloud System or a ReportSpecId to identify the associated cloud report but never both. Gets the state of progress in the creation of a new cloud report policy. For example it may be only partially configured and require the addition of credentials before it can be run. + summary: Get cloud template creation status description: Provide a ProspectiveName for the Cloud System or a ReportSpecId to identify the associated cloud report but never both. Gets the state of progress in the creation of a new cloud report policy. For example it may be only partially configured and require the addition of credentials before it can be run. operationId: GetCloudTemplateCreationStatusstatus_Get parameters: @@ -10541,7 +10541,7 @@ paths: post: tags: - cloudTemplate - summary: Provide a ProspectiveName for the Cloud System or a ReportSpecId to identify the associated cloud report but never both. Gets the state of progress in the creation of a new cloud report policy. For example it may be only partially configured and require the addition of credentials before it can be run. + summary: Get cloud template creation status description: Provide a ProspectiveName for the Cloud System or a ReportSpecId to identify the associated cloud report but never both. Gets the state of progress in the creation of a new cloud report policy. For example it may be only partially configured and require the addition of credentials before it can be run. operationId: GetCloudTemplateCreationStatusstatus_Post requestBody: @@ -10565,7 +10565,7 @@ paths: get: tags: - policyTemplate - summary: Ensures that the specified baseline template has the required source and members groups and related scheduled compliance report configured. + summary: Set up baseline policy template description: Ensures that the specified baseline template has the required source and members groups and related scheduled compliance report configured. operationId: SetupPolicyTemplatesetup_Get parameters: @@ -10593,7 +10593,7 @@ paths: post: tags: - policyTemplate - summary: Ensures that the specified baseline template has the required source and members groups and related scheduled compliance report configured. + summary: Set up baseline policy template description: Ensures that the specified baseline template has the required source and members groups and related scheduled compliance report configured. operationId: SetupPolicyTemplatesetup_Post requestBody: @@ -10617,7 +10617,7 @@ paths: get: tags: - policyTemplate - summary: Gets the state of progress in the creation of a new policy. For example it may be only partially configured and require the addition of rules before it can be applied to devices. + summary: Get policy creation status description: Gets the state of progress in the creation of a new policy. For example it may be only partially configured and require the addition of rules before it can be applied to devices. operationId: GetPolicyTemplateCreationStatusstatus_Get parameters: @@ -10645,7 +10645,7 @@ paths: post: tags: - policyTemplate - summary: Gets the state of progress in the creation of a new policy. For example it may be only partially configured and require the addition of rules before it can be applied to devices. + summary: Get policy creation status description: Gets the state of progress in the creation of a new policy. For example it may be only partially configured and require the addition of rules before it can be applied to devices. operationId: GetPolicyTemplateCreationStatusstatus_Post requestBody: @@ -10734,7 +10734,7 @@ paths: get: tags: - policyRecent - summary: Gets the most recent policy run results for each matching policy in the time range. + summary: Get most recent policy results description: Gets the most recent policy run results for each matching policy in the time range. operationId: GetMostRecentPolicyResults_Get parameters: @@ -10839,7 +10839,7 @@ paths: post: tags: - policyRecent - summary: Gets the most recent policy run results for each matching policy in the time range. + summary: Get most recent policy results description: Gets the most recent policy run results for each matching policy in the time range. operationId: GetMostRecentPolicyResults_Post requestBody: @@ -10863,7 +10863,7 @@ paths: get: tags: - policyTemplate - summary: Add a rules to a baseline policy based on events + summary: Add rules to baseline policy description: Add a rules to a baseline policy based on events operationId: AddPolicyTemplateRulesaddrules_Get parameters: @@ -10922,7 +10922,7 @@ paths: post: tags: - policyTemplate - summary: Add a rules to a baseline policy based on events + summary: Add rules to baseline policy description: Add a rules to a baseline policy based on events operationId: AddPolicyTemplateRulesaddrules_Post requestBody: @@ -10946,7 +10946,7 @@ paths: get: tags: - devicePolicyTemplate - summary: Adds a device policy template to the system. The specified template should be supplied as Xml. + summary: Add device policy template description: Adds a device policy template to the system. The specified template should be supplied as Xml. operationId: AddPolicyTemplateXmladd_Get parameters: @@ -11034,7 +11034,7 @@ paths: post: tags: - devicePolicyTemplate - summary: Adds a device policy template to the system. The specified template should be supplied as Xml. + summary: Add device policy template description: Adds a device policy template to the system. The specified template should be supplied as Xml. operationId: AddPolicyTemplateXmladd_Post requestBody: @@ -11058,7 +11058,7 @@ paths: get: tags: - devicePolicyTemplate - summary: Deletes a device policy template from the system. The specified template can be either config or a compliance report template. + summary: Delete device policy template description: Deletes a device policy template from the system. The specified template can be either config or a compliance report template. operationId: DeletePolicyTemplatedelete_Get parameters: @@ -11089,7 +11089,7 @@ paths: post: tags: - devicePolicyTemplate - summary: Deletes a device policy template from the system. The specified template can be either config or a compliance report template. + summary: Delete device policy template description: Deletes a device policy template from the system. The specified template can be either config or a compliance report template. operationId: DeletePolicyTemplatedelete_Post requestBody: @@ -11135,7 +11135,7 @@ paths: get: tags: - policyTemplateAsFile - summary: Returns a policy template as an xml file in the Http Response stream. + summary: Download policy template as XML description: Returns a policy template as an xml file in the Http Response stream. operationId: GetPolicyTemplateAsFile_Get parameters: @@ -11168,7 +11168,7 @@ paths: post: tags: - policyTemplateAsFile - summary: Returns a policy template as an xml file in the Http Response stream. + summary: Download policy template as XML description: Returns a policy template as an xml file in the Http Response stream. operationId: GetPolicyTemplateAsFile_Post requestBody: @@ -11192,7 +11192,7 @@ paths: get: tags: - agentProcesses - summary: Get the list of running processes from a specified agent / device.Used to enable 'white-listing' if existing processes from a running agent when building device config. + summary: Get agent running processes description: Get the list of running processes from a specified agent / device.Used to enable 'white-listing' if existing processes from a running agent when building device config. operationId: GetAgentProcesses_Get parameters: @@ -11220,7 +11220,7 @@ paths: post: tags: - agentProcesses - summary: Get the list of running processes from a specified agent / device.Used to enable 'white-listing' if existing processes from a running agent when building device config. + summary: Get agent running processes description: Get the list of running processes from a specified agent / device.Used to enable 'white-listing' if existing processes from a running agent when building device config. operationId: GetAgentProcesses_Post requestBody: @@ -11244,7 +11244,7 @@ paths: get: tags: - startAgentTracker - summary: Ask an agent to start a specified tracker. + summary: Start a tracker on an agent description: Ask an agent to start a specified tracker. operationId: StartAgentTracker_Get parameters: @@ -11282,7 +11282,7 @@ paths: post: tags: - startAgentTracker - summary: Ask an agent to start a specified tracker. + summary: Start a tracker on an agent description: Ask an agent to start a specified tracker. operationId: StartAgentTracker_Post requestBody: @@ -11306,7 +11306,7 @@ paths: get: tags: - agentServices - summary: Get the list of running Services from a specified agent/device. Used to enable 'white - listing' if existing Service from a running agent when building device config. + summary: Get agent running services description: Get the list of running Services from a specified agent/device. Used to enable 'white - listing' if existing Service from a running agent when building device config. operationId: GetAgentServices_Get parameters: @@ -11334,7 +11334,7 @@ paths: post: tags: - agentServices - summary: Get the list of running Services from a specified agent/device. Used to enable 'white - listing' if existing Service from a running agent when building device config. + summary: Get agent running services description: Get the list of running Services from a specified agent/device. Used to enable 'white - listing' if existing Service from a running agent when building device config. operationId: GetAgentServices_Post requestBody: @@ -11358,7 +11358,7 @@ paths: get: tags: - policyTemplates - summary: Sets a specific version of a named policy template as the active one. + summary: Set active policy template version description: Sets a specific version of a named policy template as the active one. operationId: SetActivePolicyTemplateactiveVersion_Get parameters: @@ -11389,7 +11389,7 @@ paths: post: tags: - policyTemplates - summary: Sets a specific version of a named policy template as the active one. + summary: Set active policy template version description: Sets a specific version of a named policy template as the active one. operationId: SetActivePolicyTemplateactiveVersion_Post requestBody: @@ -11615,7 +11615,7 @@ paths: get: tags: - deviceConfigTemplateNames - summary: 'Gets a list of device tracking template names, optionally filtering by trackers contained (e.g. find templates with a process tracker).' + summary: 'List device tracking template names' description: 'Gets a list of device tracking template names, optionally filtering by trackers contained (e.g. find templates with a process tracker).' operationId: GetDeviceConfigTemplateNames_Get parameters: @@ -11657,7 +11657,7 @@ paths: post: tags: - deviceConfigTemplateNames - summary: 'Gets a list of device tracking template names, optionally filtering by trackers contained (e.g. find templates with a process tracker).' + summary: 'List device tracking template names' description: 'Gets a list of device tracking template names, optionally filtering by trackers contained (e.g. find templates with a process tracker).' operationId: GetDeviceConfigTemplateNames_Post requestBody: @@ -11684,7 +11684,7 @@ paths: get: tags: - addDeviceConfigProcessRules - summary: Adds white/grey/black listing to process rules in the specified device tracking configuration template. + summary: Add process rules to tracking template description: Adds white/grey/black listing to process rules in the specified device tracking configuration template. operationId: AddDeviceConfigProcessRules_Get parameters: @@ -11718,7 +11718,7 @@ paths: post: tags: - addDeviceConfigProcessRules - summary: Adds white/grey/black listing to process rules in the specified device tracking configuration template. + summary: Add process rules to tracking template description: Adds white/grey/black listing to process rules in the specified device tracking configuration template. operationId: AddDeviceConfigProcessRules_Post requestBody: @@ -11740,7 +11740,7 @@ paths: get: tags: - groupPolicy - summary: Get the configured config policy template for the specified group or by individual template name. + summary: Get group policy template description: Get the configured config policy template for the specified group or by individual template name. operationId: GetGroupPolicy_Get parameters: @@ -11821,7 +11821,7 @@ paths: post: tags: - groupPolicy - summary: Get the configured config policy template for the specified group or by individual template name. + summary: Get group policy template description: Get the configured config policy template for the specified group or by individual template name. operationId: GetGroupPolicy_Post requestBody: @@ -11845,7 +11845,7 @@ paths: get: tags: - groupPolicyNames - summary: Get the configured config policy template names for the specified groups. + summary: Get group config policy template names description: Get the configured config policy template names for the specified groups. operationId: GetGroupPolicyConfigNames_Get parameters: @@ -11882,7 +11882,7 @@ paths: post: tags: - groupPolicyNames - summary: Get the configured config policy template names for the specified groups. + summary: Get group config policy template names description: Get the configured config policy template names for the specified groups. operationId: GetGroupPolicyConfigNames_Post requestBody: @@ -11912,7 +11912,7 @@ paths: get: tags: - groupPolicy - summary: Adds a config template to a group. + summary: Adds config template to a group. description: Adds a config template to a group. operationId: AddGroupPolicyadd_Get parameters: @@ -11960,7 +11960,7 @@ paths: post: tags: - groupPolicy - summary: Adds a config template to a group. + summary: Adds config template to a group. description: Adds a config template to a group. operationId: AddGroupPolicyadd_Post requestBody: @@ -11984,7 +11984,7 @@ paths: get: tags: - groupPolicy - summary: Removes a config template from a group. + summary: Remove template from group description: Removes a config template from a group. operationId: DeleteGroupPolicydelete_Get parameters: @@ -12015,7 +12015,7 @@ paths: post: tags: - groupPolicy - summary: Removes a config template from a group. + summary: Remove template from group description: Removes a config template from a group. operationId: DeleteGroupPolicydelete_Post requestBody: @@ -12187,7 +12187,7 @@ paths: get: tags: - agentsRanked - summary: A request to return agents matching the device filter. + summary: List agents by device filter description: A request to return agents matching the device filter. operationId: GetAgentsRanked_Get parameters: @@ -12285,7 +12285,7 @@ paths: post: tags: - agentsRanked - summary: A request to return agents matching the device filter. + summary: List agents by device filter description: A request to return agents matching the device filter. operationId: GetAgentsRanked_Post requestBody: @@ -12309,7 +12309,7 @@ paths: get: tags: - groupMembers - summary: A request to return group members matching the criteria. + summary: List group members by criteria description: A request to return group members matching the criteria. operationId: GroupMembers_Get parameters: @@ -12387,7 +12387,7 @@ paths: post: tags: - groupMembers - summary: A request to return group members matching the criteria. + summary: List group members by criteria description: A request to return group members matching the criteria. operationId: GroupMembers_Post requestBody: @@ -12532,7 +12532,7 @@ paths: get: tags: - groupsTree - summary: Gets a tree structure representing the groups hierarchy. + summary: Get groups hierarchy tree description: Gets a tree structure representing the groups hierarchy. operationId: GetGroupsTree_Get responses: @@ -12547,7 +12547,7 @@ paths: post: tags: - groupsTree - summary: Gets a tree structure representing the groups hierarchy. + summary: Get groups hierarchy tree description: Gets a tree structure representing the groups hierarchy. operationId: GetGroupsTree_Post requestBody: @@ -12571,7 +12571,7 @@ paths: get: tags: - groups - summary: Represents a request to delete a group matching the criteria. + summary: Delete matching group description: Represents a request to delete a group matching the criteria. operationId: DeleteGroupdelete_Get parameters: @@ -12597,7 +12597,7 @@ paths: post: tags: - groups - summary: Represents a request to delete a group matching the criteria. + summary: Delete matching group description: Represents a request to delete a group matching the criteria. operationId: DeleteGroupdelete_Post requestBody: @@ -12782,7 +12782,7 @@ paths: get: tags: - devices - summary: Represents a request to delete devices matching the criteria. Note that when a device is deleted it is moved to the Deleted group and is no longer included in the licensed device count. + summary: Delete devices to Deleted group description: Represents a request to delete devices matching the criteria. Note that when a device is deleted it is moved to the Deleted group and is no longer included in the licensed device count. operationId: DeleteDevicesdelete_Get parameters: @@ -12811,7 +12811,7 @@ paths: post: tags: - devices - summary: Represents a request to delete devices matching the criteria. Note that when a device is deleted it is moved to the Deleted group and is no longer included in the licensed device count. + summary: Delete devices to Deleted group description: Represents a request to delete devices matching the criteria. Note that when a device is deleted it is moved to the Deleted group and is no longer included in the licensed device count. operationId: DeleteDevicesdelete_Post requestBody: @@ -12833,7 +12833,7 @@ paths: get: tags: - devices - summary: Gets devices that have not polled in for the specified amount of time. + summary: List overdue devices description: Gets devices that have not polled in for the specified amount of time. operationId: GetOverdueDevicesoverdue_Get parameters: @@ -12880,7 +12880,7 @@ paths: post: tags: - devices - summary: Gets devices that have not polled in for the specified amount of time. + summary: List overdue devices description: Gets devices that have not polled in for the specified amount of time. operationId: GetOverdueDevicesoverdue_Post requestBody: @@ -12904,7 +12904,7 @@ paths: get: tags: - device - summary: 'Delete the specified Agent from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + summary: 'Permanently delete agent (challenge required)' description: 'Delete the specified Agent from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' operationId: DeleteDevicePermanentlydeletePermanently_Get parameters: @@ -12947,7 +12947,7 @@ paths: post: tags: - device - summary: 'Delete the specified Agent from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + summary: 'Permanently delete agent (challenge required)' description: 'Delete the specified Agent from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' operationId: DeleteDevicePermanentlydeletePermanently_Post requestBody: @@ -12971,7 +12971,7 @@ paths: get: tags: - device - summary: Represents a request to re-register a list of previously deleted devices matching the criteria. + summary: Re-register previously deleted devices description: Represents a request to re-register a list of previously deleted devices matching the criteria. operationId: ReRegisterDevicereRegister_Get parameters: @@ -13000,7 +13000,7 @@ paths: post: tags: - device - summary: Represents a request to re-register a list of previously deleted devices matching the criteria. + summary: Re-register previously deleted devices description: Represents a request to re-register a list of previously deleted devices matching the criteria. operationId: ReRegisterDevicereRegister_Post requestBody: @@ -13022,7 +13022,7 @@ paths: get: tags: - group - summary: 'Delete all the specified group members from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + summary: 'Permanently delete group members' description: 'Delete all the specified group members from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' operationId: DeleteGroupMembersPermanentlydeleteMembersPermanently_Get parameters: @@ -13055,7 +13055,7 @@ paths: post: tags: - group - summary: 'Delete all the specified group members from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + summary: 'Permanently delete group members' description: 'Delete all the specified group members from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' operationId: DeleteGroupMembersPermanentlydeleteMembersPermanently_Post requestBody: @@ -13079,7 +13079,7 @@ paths: get: tags: - deviceFilter - summary: Represents a request to add a DeviceFilter. + summary: Add DeviceFilter description: Represents a request to add a DeviceFilter. operationId: AddDeviceFilteradd_Get parameters: @@ -13107,7 +13107,7 @@ paths: post: tags: - deviceFilter - summary: Represents a request to add a DeviceFilter. + summary: Add DeviceFilter description: Represents a request to add a DeviceFilter. operationId: AddDeviceFilteradd_Post requestBody: @@ -13131,7 +13131,7 @@ paths: get: tags: - deviceFilter - summary: Represents a request to update a DeviceFilter matching the given id. + summary: Update DeviceFilter by ID description: Represents a request to update a DeviceFilter matching the given id. operationId: UpdateDeviceFilterupdate_Get parameters: @@ -13164,7 +13164,7 @@ paths: post: tags: - deviceFilter - summary: Represents a request to update a DeviceFilter matching the given id. + summary: Update DeviceFilter by ID description: Represents a request to update a DeviceFilter matching the given id. operationId: UpdateDeviceFilterupdate_Post requestBody: @@ -13188,7 +13188,7 @@ paths: get: tags: - deviceFilter - summary: 'Represents a request to bring the named filter to the head of the list, or to create it at the head of the list if it doesn''t exist.' + summary: 'Promote device filter to head' description: 'Represents a request to bring the named filter to the head of the list, or to create it at the head of the list if it doesn''t exist.' operationId: PromoteDeviceFilterpromote_Get parameters: @@ -13216,7 +13216,7 @@ paths: post: tags: - deviceFilter - summary: 'Represents a request to bring the named filter to the head of the list, or to create it at the head of the list if it doesn''t exist.' + summary: 'Promote device filter to head' description: 'Represents a request to bring the named filter to the head of the list, or to create it at the head of the list if it doesn''t exist.' operationId: PromoteDeviceFilterpromote_Post requestBody: @@ -13240,7 +13240,7 @@ paths: get: tags: - deviceFilter - summary: Represents a request to delete a DeviceFilter matching the criteria. + summary: Delete matching DeviceFilter description: Represents a request to delete a DeviceFilter matching the criteria. operationId: DeleteDeviceFilterdelete_Get parameters: @@ -13266,7 +13266,7 @@ paths: post: tags: - deviceFilter - summary: Represents a request to delete a DeviceFilter matching the criteria. + summary: Delete matching DeviceFilter description: Represents a request to delete a DeviceFilter matching the criteria. operationId: DeleteDeviceFilterdelete_Post requestBody: @@ -13288,7 +13288,7 @@ paths: get: tags: - deviceFilters - summary: Returns a paged list of DeviceFilter definitions matching the optional name criteria. + summary: List DeviceFilter definitions description: Returns a paged list of DeviceFilter definitions matching the optional name criteria. operationId: GetDeviceFilters_Get parameters: @@ -13361,7 +13361,7 @@ paths: post: tags: - deviceFilters - summary: Returns a paged list of DeviceFilter definitions matching the optional name criteria. + summary: List DeviceFilter definitions description: Returns a paged list of DeviceFilter definitions matching the optional name criteria. operationId: GetDeviceFilters_Post requestBody: @@ -13385,7 +13385,7 @@ paths: get: tags: - groupMembers - summary: A request to add the specified Groups and Agents group members to the named group. + summary: Add members to named group description: A request to add the specified Groups and Agents group members to the named group. operationId: AddGroupMembersadd_Get parameters: @@ -13435,7 +13435,7 @@ paths: post: tags: - groupMembers - summary: A request to add the specified Groups and Agents group members to the named group. + summary: Add members to named group description: A request to add the specified Groups and Agents group members to the named group. operationId: AddGroupMembersadd_Post requestBody: @@ -13457,7 +13457,7 @@ paths: get: tags: - groupMembers - summary: A request to remove group or device members from the named group. + summary: Remove members from named group description: A request to remove group or device members from the named group. operationId: DeleteGroupMembersdelete_Get parameters: @@ -13499,7 +13499,7 @@ paths: post: tags: - groupMembers - summary: A request to remove group or device members from the named group. + summary: Remove members from named group description: A request to remove group or device members from the named group. operationId: DeleteGroupMembersdelete_Post requestBody: @@ -13521,7 +13521,7 @@ paths: get: tags: - deviceOnlineStatus - summary: Gets an indication of the device's online/offline status + summary: Get device online/offline status description: Gets an indication of the device's online/offline status operationId: GetDeviceOnlineStatus_Get parameters: @@ -13555,7 +13555,7 @@ paths: post: tags: - deviceOnlineStatus - summary: Gets an indication of the device's online/offline status + summary: Get device online/offline status description: Gets an indication of the device's online/offline status operationId: GetDeviceOnlineStatus_Post requestBody: @@ -13580,7 +13580,7 @@ paths: get: tags: - deviceSettings - summary: 'Gets the device settings for the device, based on the global device settings and any device specific overrides.' + summary: 'Get device settings with overrides' description: 'Gets the device settings for the device, based on the global device settings and any device specific overrides.' operationId: UpdateDeviceSettingsupdate_Get parameters: @@ -13623,7 +13623,7 @@ paths: post: tags: - deviceSettings - summary: 'Gets the device settings for the device, based on the global device settings and any device specific overrides.' + summary: 'Get device settings with overrides' description: 'Gets the device settings for the device, based on the global device settings and any device specific overrides.' operationId: UpdateDeviceSettingsupdate_Post requestBody: @@ -13647,7 +13647,7 @@ paths: get: tags: - deviceCredentials - summary: A request to associate named credentials with an agent. + summary: Associate credentials with agent description: A request to associate named credentials with an agent. operationId: AddCredentialsToAgentDeviceadd_Get parameters: @@ -13678,7 +13678,7 @@ paths: post: tags: - deviceCredentials - summary: A request to associate named credentials with an agent. + summary: Associate credentials with agent description: A request to associate named credentials with an agent. operationId: AddCredentialsToAgentDeviceadd_Post requestBody: @@ -13700,7 +13700,7 @@ paths: get: tags: - deviceCredentials - summary: A request to remove named credentials from an agent. + summary: Remove agent credentials description: A request to remove named credentials from an agent. operationId: RemoveCredentialsFromAgentDevicedelete_Get parameters: @@ -13731,7 +13731,7 @@ paths: post: tags: - deviceCredentials - summary: A request to remove named credentials from an agent. + summary: Remove agent credentials description: A request to remove named credentials from an agent. operationId: RemoveCredentialsFromAgentDevicedelete_Post requestBody: @@ -13753,7 +13753,7 @@ paths: get: tags: - deviceName - summary: A request to update the display name of an agent. + summary: Update agent display name description: A request to update the display name of an agent. operationId: SetAgentDeviceNameupdate_Get parameters: @@ -13784,7 +13784,7 @@ paths: post: tags: - deviceName - summary: A request to update the display name of an agent. + summary: Update agent display name description: A request to update the display name of an agent. operationId: SetAgentDeviceNameupdate_Post requestBody: @@ -13806,7 +13806,7 @@ paths: get: tags: - deviceHostType - summary: A request to update the host type of an agent. + summary: Update agent host type description: A request to update the host type of an agent. operationId: SetAgentHostTypeupdate_Get parameters: @@ -13840,7 +13840,7 @@ paths: post: tags: - deviceHostType - summary: A request to update the host type of an agent. + summary: Update agent host type description: A request to update the host type of an agent. operationId: SetAgentHostTypeupdate_Post requestBody: @@ -13862,7 +13862,7 @@ paths: get: tags: - testAgentCredentials - summary: Ask an agent to test the credentials for a device it is proxying. + summary: Test proxied device credentials description: Ask an agent to test the credentials for a device it is proxying. operationId: TestAgentCredentials_Get parameters: @@ -13890,7 +13890,7 @@ paths: post: tags: - testAgentCredentials - summary: Ask an agent to test the credentials for a device it is proxying. + summary: Test proxied device credentials description: Ask an agent to test the credentials for a device it is proxying. operationId: TestAgentCredentials_Post requestBody: @@ -13914,7 +13914,7 @@ paths: get: tags: - ipBlocking - summary: Gets details of ip addresses that have been blocked. + summary: List blocked IP addresses description: Gets details of ip addresses that have been blocked. operationId: GetIpBlocking_Get parameters: @@ -13940,7 +13940,7 @@ paths: post: tags: - ipBlocking - summary: Gets details of ip addresses that have been blocked. + summary: List blocked IP addresses description: Gets details of ip addresses that have been blocked. operationId: GetIpBlocking_Post requestBody: @@ -13967,7 +13967,7 @@ paths: get: tags: - ipBlocking - summary: Adds manual blocking of a specified ip address until a specified time. + summary: Block IP address until time description: Adds manual blocking of a specified ip address until a specified time. operationId: AddIpBlockingadd_Get parameters: @@ -14005,7 +14005,7 @@ paths: post: tags: - ipBlocking - summary: Adds manual blocking of a specified ip address until a specified time. + summary: Block IP address until time description: Adds manual blocking of a specified ip address until a specified time. operationId: AddIpBlockingadd_Post requestBody: @@ -14090,7 +14090,7 @@ paths: get: tags: - discoverDevices - summary: Discovers devices to be added as proxied devices to a master device. + summary: Discover proxied devices description: Discovers devices to be added as proxied devices to a master device. operationId: DiscoverDevices_Get parameters: @@ -14113,7 +14113,7 @@ paths: post: tags: - discoverDevices - summary: Discovers devices to be added as proxied devices to a master device. + summary: Discover proxied devices description: Discovers devices to be added as proxied devices to a master device. operationId: DiscoverDevices_Post requestBody: @@ -14137,7 +14137,7 @@ paths: get: tags: - discoveredDevices - summary: Submits discovered devices as a response to a DiscoverDevices request. + summary: Submit discovered devices description: Submits discovered devices as a response to a DiscoverDevices request. operationId: SubmitDiscoveredDevices_Get parameters: @@ -14158,7 +14158,7 @@ paths: post: tags: - discoveredDevices - summary: Submits discovered devices as a response to a DiscoverDevices request. + summary: Submit discovered devices description: Submits discovered devices as a response to a DiscoverDevices request. operationId: SubmitDiscoveredDevices_Post requestBody: @@ -14180,7 +14180,7 @@ paths: get: tags: - acknowledgeEvents - summary: Acknowledge a list of events as 'planned'. + summary: Acknowledge events as planned description: Acknowledge a list of events as 'planned'. operationId: AcknowledgeEvents_Get parameters: @@ -14254,7 +14254,7 @@ paths: post: tags: - acknowledgeEvents - summary: Acknowledge a list of events as 'planned'. + summary: Acknowledge events as planned description: Acknowledge a list of events as 'planned'. operationId: AcknowledgeEvents_Post requestBody: @@ -14276,7 +14276,7 @@ paths: get: tags: - resubmitEvents - summary: 'Re-submit the specified events (i.e for re-consideration by the pipeline re: planned changes).' + summary: 'Resubmit events to pipeline' description: 'Re-submit the specified events (i.e for re-consideration by the pipeline re: planned changes).' operationId: ResubmitEvents_Get parameters: @@ -14302,7 +14302,7 @@ paths: post: tags: - resubmitEvents - summary: 'Re-submit the specified events (i.e for re-consideration by the pipeline re: planned changes).' + summary: 'Resubmit events to pipeline' description: 'Re-submit the specified events (i.e for re-consideration by the pipeline re: planned changes).' operationId: ResubmitEvents_Post requestBody: @@ -14324,7 +14324,7 @@ paths: get: tags: - event - summary: Get the event history for one specific event. + summary: Get event history description: Get the event history for one specific event. operationId: GetEventHistoryhistoryEventId_Get parameters: @@ -14352,7 +14352,7 @@ paths: post: tags: - event - summary: Get the event history for one specific event. + summary: Get event history description: Get the event history for one specific event. operationId: GetEventHistoryhistoryEventId_Post requestBody: @@ -14376,7 +14376,7 @@ paths: get: tags: - eventDeviceGroups - summary: 'Gets the list of groups that the devices associated with the given events are members of. If Intersection is true, only the groups of which all devices are a member are returned. This function is used to determine the possible groups to associate a new planned change with, such that the events will be covered by it.' + summary: 'Get device groups for events' description: 'Gets the list of groups that the devices associated with the given events are members of. If Intersection is true, only the groups of which all devices are a member are returned. This function is used to determine the possible groups to associate a new planned change with, such that the events will be covered by it.' operationId: GetEventDeviceGroups_Get parameters: @@ -14449,7 +14449,7 @@ paths: post: tags: - eventDeviceGroups - summary: 'Gets the list of groups that the devices associated with the given events are members of. If Intersection is true, only the groups of which all devices are a member are returned. This function is used to determine the possible groups to associate a new planned change with, such that the events will be covered by it.' + summary: 'Get device groups for events' description: 'Gets the list of groups that the devices associated with the given events are members of. If Intersection is true, only the groups of which all devices are a member are returned. This function is used to determine the possible groups to associate a new planned change with, such that the events will be covered by it.' operationId: GetEventDeviceGroups_Post requestBody: @@ -14526,7 +14526,7 @@ paths: get: tags: - inventory - summary: Retrieves a list of inventory items from the hub service. + summary: List inventory items description: Retrieves a list of inventory items from the hub service. operationId: GetInventory_Get parameters: @@ -14589,7 +14589,7 @@ paths: post: tags: - inventory - summary: Retrieves a list of inventory items from the hub service. + summary: List inventory items description: Retrieves a list of inventory items from the hub service. operationId: GetInventory_Post requestBody: @@ -14613,7 +14613,7 @@ paths: get: tags: - agentInventoryGrouped - summary: Retrieves a list of agent inventory items grouped by their inventory item ids from the hub service. + summary: List grouped agent inventory items description: Retrieves a list of agent inventory items grouped by their inventory item ids from the hub service. operationId: GetAgentInventoryItemsGrouped_Get parameters: @@ -14681,7 +14681,7 @@ paths: post: tags: - agentInventoryGrouped - summary: Retrieves a list of agent inventory items grouped by their inventory item ids from the hub service. + summary: List grouped agent inventory items description: Retrieves a list of agent inventory items grouped by their inventory item ids from the hub service. operationId: GetAgentInventoryItemsGrouped_Post requestBody: @@ -14705,7 +14705,7 @@ paths: get: tags: - agentInventoryAgentsDetail - summary: Retrieves a list of agents with a specific inventory item id from the hub service. + summary: List agents by inventory item ID description: Retrieves a list of agents with a specific inventory item id from the hub service. operationId: GetAgentInventoryAgentsDetail_Get parameters: @@ -14773,7 +14773,7 @@ paths: post: tags: - agentInventoryAgentsDetail - summary: Retrieves a list of agents with a specific inventory item id from the hub service. + summary: List agents by inventory item ID description: Retrieves a list of agents with a specific inventory item id from the hub service. operationId: GetAgentInventoryAgentsDetail_Post requestBody: @@ -14797,7 +14797,7 @@ paths: get: tags: - inventory - summary: A request to return the vulnerability overview matching the device filter. + summary: Get vulnerability overview by filter description: A request to return the vulnerability overview matching the device filter. operationId: GetVulnerabilityOverviewvulnerabilityOverview_Get parameters: @@ -14884,7 +14884,7 @@ paths: post: tags: - inventory - summary: A request to return the vulnerability overview matching the device filter. + summary: Get vulnerability overview by filter description: A request to return the vulnerability overview matching the device filter. operationId: GetVulnerabilityOverviewvulnerabilityOverview_Post requestBody: @@ -14908,7 +14908,7 @@ paths: get: tags: - inventory - summary: A request to return the vulnerabilities in an estate matching the device and vulnerability filters. + summary: Get estate vulnerabilities by filter description: A request to return the vulnerabilities in an estate matching the device and vulnerability filters. operationId: GetVulnerabilityvulnerabilities_Get parameters: @@ -14976,7 +14976,7 @@ paths: post: tags: - inventory - summary: A request to return the vulnerabilities in an estate matching the device and vulnerability filters. + summary: Get estate vulnerabilities by filter description: A request to return the vulnerabilities in an estate matching the device and vulnerability filters. operationId: GetVulnerabilityvulnerabilities_Post requestBody: @@ -15000,7 +15000,7 @@ paths: get: tags: - inventory - summary: A request to return the software vulnerability matching the device filter. + summary: Get software vulnerabilities by filter description: A request to return the software vulnerability matching the device filter. operationId: GetSoftwareVulnerabilitysoftwareVulnerability_Get parameters: @@ -15075,7 +15075,7 @@ paths: post: tags: - inventory - summary: A request to return the software vulnerability matching the device filter. + summary: Get software vulnerabilities by filter description: A request to return the software vulnerability matching the device filter. operationId: GetSoftwareVulnerabilitysoftwareVulnerability_Post requestBody: @@ -15099,7 +15099,7 @@ paths: get: tags: - inventory - summary: Marks an inventory item a requiring an update / refresh. + summary: Mark inventory item for update description: Marks an inventory item a requiring an update / refresh. operationId: MarkInventoryItemsRequiringUpdateupdate_Get parameters: @@ -15122,7 +15122,7 @@ paths: post: tags: - inventory - summary: Marks an inventory item a requiring an update / refresh. + summary: Mark inventory item for update description: Marks an inventory item a requiring an update / refresh. operationId: MarkInventoryItemsRequiringUpdateupdate_Post requestBody: @@ -15146,7 +15146,7 @@ paths: get: tags: - inventory - summary: A request to return the software vulnerability matching the device filter. + summary: Get software vulnerabilities by filter description: A request to return the software vulnerability matching the device filter. operationId: GetSoftwareVulnerabilityDetailsoftwareVulnerabilityDetail_Get parameters: @@ -15219,7 +15219,7 @@ paths: post: tags: - inventory - summary: A request to return the software vulnerability matching the device filter. + summary: Get software vulnerabilities by filter description: A request to return the software vulnerability matching the device filter. operationId: GetSoftwareVulnerabilityDetailsoftwareVulnerabilityDetail_Post requestBody: @@ -15243,7 +15243,7 @@ paths: get: tags: - inventory - summary: A request to return the device vulnerability matching the device filter. + summary: Get device vulnerabilities by filter description: A request to return the device vulnerability matching the device filter. operationId: GetDeviceVulnerabilitydeviceVulnerability_Get parameters: @@ -15318,7 +15318,7 @@ paths: post: tags: - inventory - summary: A request to return the device vulnerability matching the device filter. + summary: Get device vulnerabilities by filter description: A request to return the device vulnerability matching the device filter. operationId: GetDeviceVulnerabilitydeviceVulnerability_Post requestBody: @@ -15342,7 +15342,7 @@ paths: get: tags: - inventory - summary: A request to return the device vulnerability matching the device filter. + summary: Get device vulnerabilities by filter description: A request to return the device vulnerability matching the device filter. operationId: GetDeviceVulnerabilityDetaildeviceVulnerabilityDetail_Get parameters: @@ -15410,7 +15410,7 @@ paths: post: tags: - inventory - summary: A request to return the device vulnerability matching the device filter. + summary: Get device vulnerabilities by filter description: A request to return the device vulnerability matching the device filter. operationId: GetDeviceVulnerabilityDetaildeviceVulnerabilityDetail_Post requestBody: @@ -15434,7 +15434,7 @@ paths: get: tags: - inventory - summary: Get a list of CVEs that are related to the specified CPE but not directly (e.g previous versions etc) + summary: Get related CVEs for CPE description: Get a list of CVEs that are related to the specified CPE but not directly (e.g previous versions etc) operationId: GetCvesForRelatedCpesrelatedSoftwareVulnerabilityDetail_Get parameters: @@ -15473,7 +15473,7 @@ paths: post: tags: - inventory - summary: Get a list of CVEs that are related to the specified CPE but not directly (e.g previous versions etc) + summary: Get related CVEs for CPE description: Get a list of CVEs that are related to the specified CPE but not directly (e.g previous versions etc) operationId: GetCvesForRelatedCpesrelatedSoftwareVulnerabilityDetail_Post parameters: @@ -15521,7 +15521,7 @@ paths: get: tags: - inventory - summary: A request to return the vulnerable devices matching the CVE. + summary: Get vulnerable devices by CVE description: A request to return the vulnerable devices matching the CVE. operationId: GetVulnerableDeviceDetailvulnerableDeviceDetail_Get parameters: @@ -15589,7 +15589,7 @@ paths: post: tags: - inventory - summary: A request to return the vulnerable devices matching the CVE. + summary: Get vulnerable devices by CVE description: A request to return the vulnerable devices matching the CVE. operationId: GetVulnerableDeviceDetailvulnerableDeviceDetail_Post requestBody: @@ -15613,7 +15613,7 @@ paths: get: tags: - inventory - summary: A request to ignore one or more Cves until a given data. + summary: Ignore CVEs until given date description: A request to ignore one or more Cves until a given data. operationId: IgnoreCveItemignoreCves_Get parameters: @@ -15636,7 +15636,7 @@ paths: post: tags: - inventory - summary: A request to ignore one or more Cves until a given data. + summary: Ignore CVEs until given date description: A request to ignore one or more Cves until a given data. operationId: IgnoreCveItemignoreCves_Post requestBody: @@ -15660,7 +15660,7 @@ paths: get: tags: - vulnerabilityscanstatus - summary: A request to return the software vulnerability scan status. + summary: Get vulnerability scan status description: A request to return the software vulnerability scan status. operationId: GetVulnerabilityScanStatus_Get parameters: @@ -15723,7 +15723,7 @@ paths: post: tags: - vulnerabilityscanstatus - summary: A request to return the software vulnerability scan status. + summary: Get vulnerability scan status description: A request to return the software vulnerability scan status. operationId: GetVulnerabilityScanStatus_Post requestBody: @@ -15747,7 +15747,7 @@ paths: get: tags: - log4netConfigs - summary: Retrieves a list of log4net logger configurations + summary: List log4net logger configurations description: Retrieves a list of log4net logger configurations operationId: GetAllLog4NetConfigItemsall_Get responses: @@ -15762,7 +15762,7 @@ paths: post: tags: - log4netConfigs - summary: Retrieves a list of log4net logger configurations + summary: List log4net logger configurations description: Retrieves a list of log4net logger configurations operationId: GetAllLog4NetConfigItemsall_Post requestBody: @@ -15879,7 +15879,7 @@ paths: get: tags: - log4netConfigs - summary: Retrieves a list of log4net logger configurations with pagination support. + summary: List log4net logger configurations with pagination support. description: Retrieves a list of log4net logger configurations with pagination support. operationId: GetLog4NetConfigItems_Get parameters: @@ -15942,7 +15942,7 @@ paths: post: tags: - log4netConfigs - summary: Retrieves a list of log4net logger configurations with pagination support. + summary: List log4net logger configurations with pagination support. description: Retrieves a list of log4net logger configurations with pagination support. operationId: GetLog4NetConfigItems_Post requestBody: @@ -15966,7 +15966,7 @@ paths: get: tags: - reportDescription - summary: Returns a description for the specified report. + summary: Get report description description: Returns a description for the specified report. operationId: GetReportDescription_Get parameters: @@ -15989,7 +15989,7 @@ paths: post: tags: - reportDescription - summary: Returns a description for the specified report. + summary: Get report description description: Returns a description for the specified report. operationId: GetReportDescription_Post requestBody: @@ -16013,7 +16013,7 @@ paths: get: tags: - reportDifferences - summary: Get a list of differences between two reports runs. + summary: Differences between two report runs description: Get a list of differences between two reports runs. operationId: GetReportChangeDetails_Get parameters: @@ -16039,7 +16039,7 @@ paths: post: tags: - reportDifferences - summary: Get a list of differences between two reports runs. + summary: Differences between two report runs description: Get a list of differences between two reports runs. operationId: GetReportChangeDetails_Post requestBody: @@ -16066,7 +16066,7 @@ paths: get: tags: - reportData - summary: 'Gets report results for the specified agent, device or task id.' + summary: 'Get report results' description: 'Gets report results for the specified agent, device or task id.' operationId: GetReportDatareportId_Get parameters: @@ -16129,7 +16129,7 @@ paths: post: tags: - reportData - summary: 'Gets report results for the specified agent, device or task id.' + summary: 'Get report results' description: 'Gets report results for the specified agent, device or task id.' operationId: GetReportDatareportId_Post requestBody: @@ -16153,7 +16153,7 @@ paths: get: tags: - availableReports - summary: ' Gets a list of available reports for a specified group or agent.' + summary: 'List available reports' description: ' Gets a list of available reports for a specified group or agent.' operationId: GetAvailableReports_Get parameters: @@ -16193,7 +16193,7 @@ paths: post: tags: - availableReports - summary: ' Gets a list of available reports for a specified group or agent.' + summary: 'List available reports' description: ' Gets a list of available reports for a specified group or agent.' operationId: GetAvailableReports_Post requestBody: @@ -16269,7 +16269,7 @@ paths: get: tags: - userDashboard - summary: Gets the user dashboard widget layout by name. + summary: Get dashboard widget layout by name description: Gets the user dashboard widget layout by name. operationId: GetUserDashboardByNamenamed_Get parameters: @@ -16297,7 +16297,7 @@ paths: post: tags: - userDashboard - summary: Gets the user dashboard widget layout by name. + summary: Get dashboard widget layout by name description: Gets the user dashboard widget layout by name. operationId: GetUserDashboardByNamenamed_Post requestBody: @@ -16677,7 +16677,7 @@ paths: get: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedatastartStart_Get parameters: @@ -16746,7 +16746,7 @@ paths: post: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedatastartStart_Post requestBody: @@ -16770,7 +16770,7 @@ paths: get: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedataendEnd_Get parameters: @@ -16839,7 +16839,7 @@ paths: post: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedataendEnd_Post requestBody: @@ -16863,7 +16863,7 @@ paths: get: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedatastartStartendEnd_Get parameters: @@ -16932,7 +16932,7 @@ paths: post: tags: - stats - summary: 'Get report summaries by report, for either individual devices, or as group average.' + summary: 'Get device or group report summaries' description: 'Get report summaries by report, for either individual devices, or as group average.' operationId: GetComplianceDatacompliancedatastartStartendEnd_Post requestBody: @@ -16956,7 +16956,7 @@ paths: get: tags: - stats - summary: Represents a request to invalidate the eventcount stats for a group for a specific set of periods. + summary: Invalidate group event count stats description: Represents a request to invalidate the eventcount stats for a group for a specific set of periods. operationId: InvalidateEventCountseventsinvalidate_Get parameters: @@ -16977,7 +16977,7 @@ paths: post: tags: - stats - summary: Represents a request to invalidate the eventcount stats for a group for a specific set of periods. + summary: Invalidate group event count stats description: Represents a request to invalidate the eventcount stats for a group for a specific set of periods. operationId: InvalidateEventCountseventsinvalidate_Post requestBody: @@ -17046,7 +17046,7 @@ paths: get: tags: - testFastConnection - summary: Tests the configured Fast service can be contacted. + summary: Test Fast service connection description: Tests the configured Fast service can be contacted. operationId: TestFastConnection_Get parameters: @@ -17069,7 +17069,7 @@ paths: post: tags: - testFastConnection - summary: Tests the configured Fast service can be contacted. + summary: Test Fast service connection description: Tests the configured Fast service can be contacted. operationId: TestFastConnection_Post requestBody: @@ -17093,7 +17093,7 @@ paths: get: tags: - testFastCustomerConnection - summary: Tests the configured Fast service can be contacted using customer credentials. + summary: Test Fast service with credentials description: Tests the configured Fast service can be contacted using customer credentials. operationId: TestFastCustomerConnection_Get parameters: @@ -17116,7 +17116,7 @@ paths: post: tags: - testFastCustomerConnection - summary: Tests the configured Fast service can be contacted using customer credentials. + summary: Test Fast service with credentials description: Tests the configured Fast service can be contacted using customer credentials. operationId: TestFastCustomerConnection_Post requestBody: @@ -17281,7 +17281,7 @@ paths: get: tags: - pipelineNodes - summary: Gets a list of pipeline node names. + summary: Lists pipeline node names. description: Gets a list of pipeline node names. operationId: GetPipelineNodeList_Get parameters: @@ -17307,7 +17307,7 @@ paths: post: tags: - pipelineNodes - summary: Gets a list of pipeline node names. + summary: Lists pipeline node names. description: Gets a list of pipeline node names. operationId: GetPipelineNodeList_Post requestBody: @@ -17381,7 +17381,7 @@ paths: post: tags: - users - summary: Represents a pre-authentication request to query the user's Two-factor authentication status. Counts as a sign-in attempt. + summary: Query user two-factor status description: Represents a pre-authentication request to query the user's Two-factor authentication status. Counts as a sign-in attempt. operationId: GetUserTwoFactorStatustwoFactorStatus_Post requestBody: @@ -17403,7 +17403,7 @@ paths: post: tags: - users - summary: Represents a post-authentication request to elevate the user's Two-factor authentication status. Counts as a sign-in attempt. + summary: Elevate user two-factor status description: Represents a post-authentication request to elevate the user's Two-factor authentication status. Counts as a sign-in attempt. operationId: ElevateUserTwoFactorStatuselevateTwoFactorStatus_Post requestBody: @@ -17556,7 +17556,7 @@ paths: get: tags: - users - summary: Updates stored user details. Note that UserManage permissions are required to manage any user other than the caller. + summary: Update stored user details description: Updates stored user details. Note that UserManage permissions are required to manage any user other than the caller. operationId: UpdateUserupdate_Get parameters: @@ -17577,7 +17577,7 @@ paths: post: tags: - users - summary: Updates stored user details. Note that UserManage permissions are required to manage any user other than the caller. + summary: Update stored user details description: Updates stored user details. Note that UserManage permissions are required to manage any user other than the caller. operationId: UpdateUserupdate_Post requestBody: @@ -17599,7 +17599,7 @@ paths: get: tags: - users - summary: Updates stored user password. CurrentPassword property should contain the password of the user attempting to make the change. Note that UserManage permissions are required to manage any user password other than caller's. + summary: Update user password description: Updates stored user password. CurrentPassword property should contain the password of the user attempting to make the change. Note that UserManage permissions are required to manage any user password other than caller's. operationId: UpdateUserPasswordupdatePassword_Get parameters: @@ -17620,7 +17620,7 @@ paths: post: tags: - users - summary: Updates stored user password. CurrentPassword property should contain the password of the user attempting to make the change. Note that UserManage permissions are required to manage any user password other than caller's. + summary: Update user password description: Updates stored user password. CurrentPassword property should contain the password of the user attempting to make the change. Note that UserManage permissions are required to manage any user password other than caller's. operationId: UpdateUserPasswordupdatePassword_Post requestBody: @@ -17642,7 +17642,7 @@ paths: get: tags: - users - summary: Resets a user. Note that UserManage permissions are required to manage any user other than the caller. + summary: Reset user description: Resets a user. Note that UserManage permissions are required to manage any user other than the caller. operationId: ResetUserreset_Get parameters: @@ -17663,7 +17663,7 @@ paths: post: tags: - users - summary: Resets a user. Note that UserManage permissions are required to manage any user other than the caller. + summary: Reset user description: Resets a user. Note that UserManage permissions are required to manage any user other than the caller. operationId: ResetUserreset_Post requestBody: @@ -17685,7 +17685,7 @@ paths: get: tags: - users - summary: Resets a user password. Note that this operation is intended to manage any user other than the caller. + summary: Reset user password description: Resets a user password. Note that this operation is intended to manage any user other than the caller. operationId: ResetUserPasswordresetPassword_Get parameters: @@ -17708,7 +17708,7 @@ paths: post: tags: - users - summary: Resets a user password. Note that this operation is intended to manage any user other than the caller. + summary: Reset user password description: Resets a user password. Note that this operation is intended to manage any user other than the caller. operationId: ResetUserPasswordresetPassword_Post requestBody: @@ -17732,7 +17732,7 @@ paths: post: tags: - users - summary: Generates a reset password for preview without applying it. Pass the returned PreviewToken to resetPassword to apply it. + summary: Generate preview reset password description: Generates a reset password for preview without applying it. Pass the returned PreviewToken to resetPassword to apply it. operationId: PreviewResetUserPasswordpreviewResetPassword_Post requestBody: @@ -17756,7 +17756,7 @@ paths: get: tags: - users - summary: Resets a user's 2FA . Note that UserManage permissions are required to manage any user other than the caller. + summary: Reset user 2FA description: Resets a user's 2FA . Note that UserManage permissions are required to manage any user other than the caller. operationId: ResetUser2fareset2fa_Get parameters: @@ -17777,7 +17777,7 @@ paths: post: tags: - users - summary: Resets a user's 2FA . Note that UserManage permissions are required to manage any user other than the caller. + summary: Reset user 2FA description: Resets a user's 2FA . Note that UserManage permissions are required to manage any user other than the caller. operationId: ResetUser2fareset2fa_Post requestBody: @@ -17799,7 +17799,7 @@ paths: get: tags: - exportUserNotifications - summary: Export users and the notifications they are configured to receive + summary: Export user notifications description: Export users and the notifications they are configured to receive operationId: ExportUserNotifications_Get parameters: @@ -17822,7 +17822,7 @@ paths: post: tags: - exportUserNotifications - summary: Export users and the notifications they are configured to receive + summary: Export user notifications description: Export users and the notifications they are configured to receive operationId: ExportUserNotifications_Post requestBody: @@ -17846,7 +17846,7 @@ paths: get: tags: - timezones - summary: Gets a list of possible time zone names. + summary: List time zone names description: Gets a list of possible time zone names. operationId: GetTimeZoneIds_Get parameters: @@ -17872,7 +17872,7 @@ paths: post: tags: - timezones - summary: Gets a list of possible time zone names. + summary: List time zone names description: Gets a list of possible time zone names. operationId: GetTimeZoneIds_Post requestBody: @@ -17899,7 +17899,7 @@ paths: get: tags: - userHasChangedPassword - summary: Has the current user changed their password from any system assigned one? + summary: Check if user changed password description: Has the current user changed their password from any system assigned one? operationId: UserHasChangedPassword_Get parameters: @@ -17923,7 +17923,7 @@ paths: post: tags: - userHasChangedPassword - summary: Has the current user changed their password from any system assigned one? + summary: Check if user changed password description: Has the current user changed their password from any system assigned one? operationId: UserHasChangedPassword_Post requestBody: @@ -17948,7 +17948,7 @@ paths: get: tags: - groupAlerts - summary: Add a group alert to a user. + summary: Add group alert to user description: Add a group alert to a user. operationId: AddGroupAlertToUseradd_Get parameters: @@ -17971,7 +17971,7 @@ paths: post: tags: - groupAlerts - summary: Add a group alert to a user. + summary: Add group alert to user description: Add a group alert to a user. operationId: AddGroupAlertToUseradd_Post requestBody: @@ -17995,7 +17995,7 @@ paths: get: tags: - groupAlerts - summary: Remove a group notification from a user + summary: Remove group notification from user description: Remove a group notification from a user operationId: DeleteGroupAlertFromUserdelete_Get parameters: @@ -18026,7 +18026,7 @@ paths: post: tags: - groupAlerts - summary: Remove a group notification from a user + summary: Remove group notification from user description: Remove a group notification from a user operationId: DeleteGroupAlertFromUserdelete_Post requestBody: @@ -18048,7 +18048,7 @@ paths: get: tags: - groupAlerts - summary: Update a group notification from a user + summary: Update group notification for user description: Update a group notification from a user operationId: UpdateGroupAlertForUserupdate_Get parameters: @@ -18069,7 +18069,7 @@ paths: post: tags: - groupAlerts - summary: Update a group notification from a user + summary: Update group notification for user description: Update a group notification from a user operationId: UpdateGroupAlertForUserupdate_Post requestBody: @@ -18091,7 +18091,7 @@ paths: get: tags: - groupAlerts - summary: Get the configured notifications for the specified group. + summary: Get notifications for group description: Get the configured notifications for the specified group. operationId: GetGroupAlertsForGroup_Get parameters: @@ -18117,7 +18117,7 @@ paths: post: tags: - groupAlerts - summary: Get the configured notifications for the specified group. + summary: Get notifications for group description: Get the configured notifications for the specified group. operationId: GetGroupAlertsForGroup_Post requestBody: @@ -18197,7 +18197,7 @@ paths: get: tags: - resetAdminPassword - summary: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + summary: 'Reset admin account password' description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' operationId: ResetAdminPassword_Get parameters: @@ -18218,7 +18218,7 @@ paths: post: tags: - resetAdminPassword - summary: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + summary: 'Reset admin account password' description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' operationId: ResetAdminPassword_Post requestBody: @@ -18240,7 +18240,7 @@ paths: get: tags: - resetAdminPassword - summary: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + summary: 'Reset admin account password' description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' operationId: ResetAdminPasswordAdminName_Get parameters: @@ -18261,7 +18261,7 @@ paths: post: tags: - resetAdminPassword - summary: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + summary: 'Reset admin account password' description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' operationId: ResetAdminPasswordAdminName_Post requestBody: @@ -18283,7 +18283,7 @@ paths: get: tags: - resetAdminPassword - summary: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + summary: 'Reset admin account password' description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' operationId: ResetAdminPasswordOrganizationIdAdminName_Get parameters: @@ -18304,7 +18304,7 @@ paths: post: tags: - resetAdminPassword - summary: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + summary: 'Reset admin account password' description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' operationId: ResetAdminPasswordOrganizationIdAdminName_Post requestBody: @@ -18326,7 +18326,7 @@ paths: get: tags: - userRoles - summary: Get a list of user roles defined in the system. + summary: List user roles description: Get a list of user roles defined in the system. operationId: GetUserRoles_Get parameters: @@ -18349,7 +18349,7 @@ paths: post: tags: - userRoles - summary: Get a list of user roles defined in the system. + summary: List user roles description: Get a list of user roles defined in the system. operationId: GetUserRoles_Post requestBody: @@ -18373,7 +18373,7 @@ paths: get: tags: - permissions - summary: Gets a list of permissions names defined in the system. + summary: List permission names description: Gets a list of permissions names defined in the system. operationId: GetPermissions_Get parameters: @@ -18399,7 +18399,7 @@ paths: post: tags: - permissions - summary: Gets a list of permissions names defined in the system. + summary: List permission names description: Gets a list of permissions names defined in the system. operationId: GetPermissions_Post requestBody: @@ -18673,7 +18673,7 @@ paths: get: tags: - licenseInfo - summary: Represents a request to get an Organization's license info. + summary: Get organization license info description: Represents a request to get an Organization's license info. operationId: GetLicenseInfo_Get parameters: @@ -18696,7 +18696,7 @@ paths: post: tags: - licenseInfo - summary: Represents a request to get an Organization's license info. + summary: Get organization license info description: Represents a request to get an Organization's license info. operationId: GetLicenseInfo_Post requestBody: @@ -18720,7 +18720,7 @@ paths: get: tags: - organization - summary: 'Represents a request to update an Organization, used to set the license.' + summary: 'Update organization license' description: 'Represents a request to update an Organization, used to set the license.' operationId: UpdateOrganizationupdate_Get parameters: @@ -18752,7 +18752,7 @@ paths: post: tags: - organization - summary: 'Represents a request to update an Organization, used to set the license.' + summary: 'Update organization license' description: 'Represents a request to update an Organization, used to set the license.' operationId: UpdateOrganizationupdate_Post requestBody: @@ -18774,7 +18774,7 @@ paths: get: tags: - userRolesPermisions - summary: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + summary: 'Check user roles and permissions' description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' operationId: HasRoleOrPermissioncheck_Get parameters: @@ -18798,7 +18798,7 @@ paths: post: tags: - userRolesPermisions - summary: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + summary: 'Check user roles and permissions' description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' operationId: HasRoleOrPermissioncheck_Post requestBody: @@ -18823,7 +18823,7 @@ paths: get: tags: - userRolesPermissions - summary: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + summary: 'Check user roles and permissions' description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' operationId: HasRoleOrPermissioncheck2_Get parameters: @@ -18847,7 +18847,7 @@ paths: post: tags: - userRolesPermissions - summary: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + summary: 'Check user roles and permissions' description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' operationId: HasRoleOrPermissioncheck2_Post requestBody: @@ -18872,7 +18872,7 @@ paths: get: tags: - userRolesPermisions - summary: 'Gets roles and permissions for the caller, or the named user if supplied.' + summary: 'Get user roles and permissions' description: 'Gets roles and permissions for the caller, or the named user if supplied.' operationId: GetRolesAndPermissions_Get parameters: @@ -18895,7 +18895,7 @@ paths: post: tags: - userRolesPermisions - summary: 'Gets roles and permissions for the caller, or the named user if supplied.' + summary: 'Get user roles and permissions' description: 'Gets roles and permissions for the caller, or the named user if supplied.' operationId: GetRolesAndPermissions_Post requestBody: @@ -18919,7 +18919,7 @@ paths: get: tags: - userRolesPermissions - summary: 'Gets roles and permissions for the caller, or the named user if supplied.' + summary: 'Get user roles and permissions' description: 'Gets roles and permissions for the caller, or the named user if supplied.' operationId: GetRolesAndPermissions2_Get parameters: @@ -18942,7 +18942,7 @@ paths: post: tags: - userRolesPermissions - summary: 'Gets roles and permissions for the caller, or the named user if supplied.' + summary: 'Get user roles and permissions' description: 'Gets roles and permissions for the caller, or the named user if supplied.' operationId: GetRolesAndPermissions2_Post requestBody: From 87c1cd931eec01ed1b00c7f93414bab6b307071b Mon Sep 17 00:00:00 2001 From: Dan Piazza <220388267+DanPiazza-Netwrix@users.noreply.github.com> Date: Thu, 14 May 2026 16:36:36 -0400 Subject: [PATCH 2/2] docs(changetracker): expand all OpenAPI operation descriptions Rewrites every operation-level description in the Change Tracker Hub OpenAPI spec to be professional, user-facing prose. No description is now a verbatim copy of its summary. All 528 operations updated. Generated with AI Co-Authored-By: Claude Code --- static/openapi/changetracker-hub-8.1.yaml | 1056 ++++++++++----------- 1 file changed, 528 insertions(+), 528 deletions(-) diff --git a/static/openapi/changetracker-hub-8.1.yaml b/static/openapi/changetracker-hub-8.1.yaml index 3541efe262..313c709b45 100644 --- a/static/openapi/changetracker-hub-8.1.yaml +++ b/static/openapi/changetracker-hub-8.1.yaml @@ -10,7 +10,7 @@ paths: tags: - command summary: 'Poll agent tasks and template dates' - description: 'Called by the agent, this returns a list of AgentTasks and latest tracking template definition dates for all the devices the agent manages.' + description: 'Returns a list of pending AgentTasks and the latest tracking template definition dates for all devices managed by the specified agent. Use this endpoint during the agent polling cycle to determine which tasks to execute and whether any template definitions have been updated since the last poll.' operationId: GetAgentPolltaskspollAgentId_Get parameters: - name: UniqueId @@ -119,7 +119,7 @@ paths: tags: - command summary: 'Poll agent tasks and template dates' - description: 'Called by the agent, this returns a list of AgentTasks and latest tracking template definition dates for all the devices the agent manages.' + description: 'Returns a list of pending AgentTasks and the latest tracking template definition dates for all devices managed by the specified agent. Submit this request when the agent polls for new work, allowing the hub to communicate task assignments and template update notifications.' operationId: GetAgentPolltaskspollAgentId_Post requestBody: content: @@ -143,7 +143,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns task information for the specified agent, optionally filtered by AgentId, DeviceId, task status, task IDs, or policy run ID. Use the Concise flag to omit large text and result-data fields from the response, and use the pagination parameters to page through large result sets. operationId: GetAgentTaskstasksagentAgentId_Get parameters: - name: AgentId @@ -258,7 +258,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Submits a request for task information for the specified agent. Accepts the same filtering options as the GET variant, including task status, task type, and Concise mode, via the request body. operationId: GetAgentTaskstasksagentAgentId_Post requestBody: content: @@ -282,7 +282,7 @@ paths: tags: - submitAgentTaskResultStream summary: Stream agent task result data - description: Used to submit agent task result data to the hub as a stream. + description: Submits agent task result data to the hub as a streaming upload. Use this endpoint when the result payload is too large to send as a single request body, sending chunks incrementally until the task result is complete. operationId: SubmitAgentTaskResultStreamAgentIdDeviceIdTaskId_Post requestBody: content: @@ -306,7 +306,7 @@ paths: tags: - submitAgentTaskResultData summary: 'Submit Gen 7 agent task data' - description: 'Adds report result data for the given agent report, called by the agent. This is the new format used by the Gen 7 agent.' + description: Submits report result data to the hub for the specified agent report task using the Gen 7 format. Provide the TaskId, result DataValues, and final Status to indicate whether the task completed successfully or encountered an error. operationId: SubmitAgentTaskResultData_Get parameters: - name: AgentId @@ -365,7 +365,7 @@ paths: tags: - submitAgentTaskResultData summary: 'Submit Gen 7 agent task data' - description: 'Adds report result data for the given agent report, called by the agent. This is the new format used by the Gen 7 agent.' + description: Submits report result data to the hub for the specified agent report task using the Gen 7 format. Supply the TaskId, DataValues, and Status in the request body to record the outcome of the completed task. operationId: SubmitAgentTaskResultData_Post requestBody: content: @@ -387,7 +387,7 @@ paths: tags: - submitAgentTaskResult summary: 'Submit agent task result' - description: 'Adds task result data for the given agent task, called by the agent.' + description: Submits task result data to the hub for the specified agent task. Supply the AgentId, DeviceId, and TaskId along with the result payload, which may be a single string in ResultData, a list of items in ResultDataItems, or rule evaluation results in RuleItemResults. operationId: SubmitAgentTaskResult_Get parameters: - name: AgentId @@ -475,7 +475,7 @@ paths: tags: - submitAgentTaskResult summary: 'Submit agent task result' - description: 'Adds task result data for the given agent task, called by the agent.' + description: Submits task result data to the hub for the specified agent task. Supply the AgentId, DeviceId, TaskId, result payload, and final Status in the request body. operationId: SubmitAgentTaskResult_Post requestBody: content: @@ -497,7 +497,7 @@ paths: tags: - credential summary: Get credentials by type and key - description: Get specific credentials for requested type and key (name). + description: Returns the stored credentials matching the specified type and key name. Supported credential types include Shell, Database, FTP, Cloud, ESX, ITSM, and Splunk. Use this endpoint to retrieve connection credentials for use by agents or proxy configurations. operationId: GetCredentials_Get parameters: - name: CredentialsType @@ -540,7 +540,7 @@ paths: tags: - credential summary: Get credentials by type and key - description: Get specific credentials for requested type and key (name). + description: Returns the stored credentials matching the specified type and key name supplied in the request body. Supported credential types include Shell, Database, FTP, Cloud, ESX, ITSM, and Splunk. operationId: GetCredentials_Post requestBody: content: @@ -564,7 +564,7 @@ paths: tags: - policyTemplates summary: Gets matching config templates. - description: Gets matching config templates. + description: Returns configuration policy templates matching the specified filter criteria. Filter by name, name substring, template version, tracker type, usage tags, or trust status. Set ReturnXml to true to include the full template XML definition in the response. operationId: GetPolicyTemplates_Get parameters: - name: Name @@ -713,7 +713,7 @@ paths: tags: - policyTemplates summary: Gets matching config templates. - description: Gets matching config templates. + description: Returns configuration policy templates matching the filter criteria supplied in the request body. Supports the same filtering options as the GET variant, including name, tracker type, usage tags, and pagination. operationId: GetPolicyTemplates_Post requestBody: content: @@ -737,7 +737,7 @@ paths: tags: - policyTemplateVariables summary: Get report variable definitions - description: A request to get a list of variable definitions from a named report to be collected by the agent. + description: Returns a list of variable definitions from the specified report template that the agent must collect. Use the ReturnConfigAsXml flag to receive any required configuration as an XML string rather than a structured object. operationId: GetPolicyTemplateVariables_Get parameters: - name: PolicyTemplateName @@ -771,7 +771,7 @@ paths: tags: - policyTemplateVariables summary: Get report variable definitions - description: A request to get a list of variable definitions from a named report to be collected by the agent. + description: Returns a list of variable definitions from the specified report template that the agent must collect. Supply the template name and format preference in the request body. operationId: GetPolicyTemplateVariables_Post requestBody: content: @@ -795,7 +795,7 @@ paths: tags: - deviceCredentials summary: Get agent credential names - description: A request to get the names of credentials associated with an agent. + description: Returns the names of all credentials associated with the specified agent device. Use this endpoint to discover which credential sets are available before making targeted credential lookup calls. operationId: GetCredentialsForAgentDevice_Get parameters: - name: AgentDevice @@ -826,7 +826,7 @@ paths: tags: - deviceCredentials summary: Get agent credential names - description: A request to get the names of credentials associated with an agent. + description: Returns the names of all credentials associated with the specified agent device. Supply the agent device details in the request body. operationId: GetCredentialsForAgentDevice_Post requestBody: content: @@ -853,7 +853,7 @@ paths: tags: - deviceDbCredentials summary: Get proxied agent database credentials - description: A request to get the database credentials associated with a database proxied agent. + description: Returns the database credentials associated with the specified database-proxied agent device. Use this endpoint when a proxy agent needs to retrieve connection credentials for the database device it manages. operationId: GetDbCredentialForDatabaseAgentDevice_Get parameters: - name: AgentDevice @@ -881,7 +881,7 @@ paths: tags: - deviceDbCredentials summary: Get proxied agent database credentials - description: A request to get the database credentials associated with a database proxied agent. + description: Returns the database credentials associated with the specified database-proxied agent device. Supply the agent device details in the request body. operationId: GetDbCredentialForDatabaseAgentDevice_Post requestBody: content: @@ -905,7 +905,7 @@ paths: tags: - groupMemberships summary: 'Get agent or group memberships' - description: 'A request to return groups this agent or group is a member of, including parents of parents etc.' + description: Returns all groups that the specified agent or group belongs to, including transitively inherited parent groups. For example, if a device belongs to a "Windows 7" group that is itself a member of a "Windows" group, both groups are returned unless ExcludeInherited is set to true. operationId: GroupMemberships_Get parameters: - name: MemberName @@ -952,7 +952,7 @@ paths: tags: - groupMemberships summary: 'Get agent or group memberships' - description: 'A request to return groups this agent or group is a member of, including parents of parents etc.' + description: Returns all groups that the specified agent or group belongs to, including transitively inherited parent groups. Supply the member name, member type, and ExcludeInherited preference in the request body. operationId: GroupMemberships_Post requestBody: content: @@ -979,7 +979,7 @@ paths: tags: - agents summary: List agents by device filter - description: A request to return agents matching the device filter. + description: Returns a list of agents matching the specified device filter. Use the optional flags to include related data such as group details, credentials, planned changes, proxy agents, and applied templates. Supports pagination and sorting through the standard query parameters. operationId: GetAgents_Get parameters: - name: ExcludeTotalCount @@ -1089,7 +1089,7 @@ paths: tags: - agents summary: List agents by device filter - description: A request to return agents matching the device filter. + description: Returns a list of agents matching the specified device filter. Supply all filter and pagination options in the request body. Supports the same related-data flags as the GET variant. operationId: GetAgents_Post requestBody: content: @@ -1113,7 +1113,7 @@ paths: tags: - agents summary: Register agent details - description: Registers the details of an Agent with the system. + description: Registers a new agent or proxied device with the hub and returns the resulting Agent record. Supply device properties such as host name, host type, group memberships, and credentials. The UniqueId parameter prevents duplicate registrations if the hub store is reset and agent IDs are reissued. operationId: RegisterAgentregister_Get parameters: - name: CanProxy @@ -1268,7 +1268,7 @@ paths: tags: - agents summary: Register agent details - description: Registers the details of an Agent with the system. + description: Registers a new agent or proxied device with the hub and returns the resulting Agent record. Supply all device properties in the request body, including host name, host type, group memberships, and credentials. operationId: RegisterAgentregister_Post requestBody: content: @@ -1292,7 +1292,7 @@ paths: tags: - agents summary: Update an Agent's details. - description: Update an Agent's details. + description: Updates the specified agent's details and returns the refreshed agent list. Use the Update* boolean flags to control which fields are actually written, allowing partial updates without overwriting fields that were not supplied. operationId: UpdateAgentupdate_Get parameters: - name: Agent @@ -1416,7 +1416,7 @@ paths: tags: - agents summary: Update an Agent's details. - description: Update an Agent's details. + description: Updates the specified agent's details and returns the refreshed agent list. Supply the agent object and the Update* boolean flags in the request body to control which fields are written. operationId: UpdateAgentupdate_Post requestBody: content: @@ -1440,7 +1440,7 @@ paths: tags: - agents summary: Find agents by filter and criteria - description: A request to find agents matching the device filter and search criteria. + description: Returns agents that match both the device filter and the specified text search criteria. Use this endpoint to perform free-text searches across agent fields, with the results scoped to the devices identified by the DeviceFilter. operationId: SearchAgentssearch_Get parameters: - name: DeviceFilter @@ -1513,7 +1513,7 @@ paths: tags: - agents summary: Find agents by filter and criteria - description: A request to find agents matching the device filter and search criteria. + description: Returns agents that match both the device filter and text search criteria supplied in the request body. Accepts the same filter and pagination options as the GET variant. operationId: SearchAgentssearch_Post requestBody: content: @@ -1537,7 +1537,7 @@ paths: tags: - agents summary: Register specified agents - description: Registers the details of the specified Agents with the system. + description: Pre-registers a batch of agents with the hub before they connect for the first time. Returns the pre-registration response for each supplied agent, allowing you to provision agent records in advance of deployment. operationId: PreRegisterAgentspreRegister_Get parameters: - name: Agents @@ -1568,7 +1568,7 @@ paths: tags: - agents summary: Register specified agents - description: Registers the details of the specified Agents with the system. + description: Pre-registers a batch of agents with the hub before they connect for the first time. Supply the list of agent registration details in the request body. operationId: PreRegisterAgentspreRegister_Post requestBody: content: @@ -1592,7 +1592,7 @@ paths: tags: - deviceConfig summary: Get merged device tracking config - description: Get the tracking configuration template from the merged result of the group configurations for the groups the device is in. + description: Returns the effective tracking configuration for the specified device by merging all group-level policy templates that apply to it. Use ReturnDocument to receive a structured template object, or set it to false to receive the raw XML string. operationId: GetDeviceConfig_Get parameters: - name: AgentDevice @@ -1637,7 +1637,7 @@ paths: tags: - deviceConfig summary: Get merged device tracking config - description: Get the tracking configuration template from the merged result of the group configurations for the groups the device is in. + description: Returns the effective tracking configuration for the specified device by merging all group-level policy templates that apply to it. Supply the agent device identifier and response format preference in the request body. operationId: GetDeviceConfig_Post requestBody: content: @@ -1661,7 +1661,7 @@ paths: tags: - deviceSettings summary: 'Get device or group settings' - description: 'Gets the device settings for the device or group, based on the global device settings and any group specific overrides.' + description: 'Returns the effective device settings for the specified device or group, combining the global defaults with any group-specific overrides. Provide either an AgentId and DeviceId pair or a GroupName to identify the target.' operationId: GetDeviceSettings_Get parameters: - name: AgentId @@ -1699,7 +1699,7 @@ paths: tags: - deviceSettings summary: 'Get device or group settings' - description: 'Gets the device settings for the device or group, based on the global device settings and any group specific overrides.' + description: 'Returns the effective device settings for the specified device or group, combining the global defaults with any group-specific overrides. Supply the AgentId and DeviceId pair or GroupName in the request body.' operationId: GetDeviceSettings_Post requestBody: content: @@ -1723,7 +1723,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns a filtered list of events from the hub. Use the DeviceFilter and EventFilter to scope results by device and event type, the StartUtc and EndUtc parameters to define the time window, and the pagination parameters to control the result set size. Optionally include event history or populate the AllEvents list by setting the corresponding flags. operationId: GetEvents_Get parameters: - name: Comment @@ -1900,7 +1900,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns a filtered list of events from the hub. Supply device filter, event filter, time range, and pagination options in the request body. Supports the same filtering and response options as the GET variant. operationId: GetEvents_Post requestBody: content: @@ -1924,7 +1924,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns events from the hub starting at the specified UTC timestamp supplied in the path. Use the DeviceFilter, EventFilter, and pagination parameters to further narrow results. The StartUtc path parameter is combined with EndUtc and any offset values in the query string. operationId: GetEventsstartStartUtc_Get parameters: - name: Comment @@ -2101,7 +2101,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns events from the hub starting at the specified UTC timestamp in the path. Supply additional filters, pagination, and format options in the request body. operationId: GetEventsstartStartUtc_Post requestBody: content: @@ -2125,7 +2125,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns events from the hub up to the specified end timestamp supplied in the path. Use the DeviceFilter, EventFilter, and pagination parameters to further narrow results. operationId: GetEventsendEnd_Get parameters: - name: Comment @@ -2302,7 +2302,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns events from the hub up to the specified end timestamp in the path. Supply additional filters, pagination, and format options in the request body. operationId: GetEventsendEnd_Post requestBody: content: @@ -2326,7 +2326,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns events from the hub within the date range defined by the StartUtc and End path parameters. Use this endpoint for time-bounded queries without relying on query string date parameters, and combine it with device and event filters for more precise results. operationId: GetEventsstartStartUtcendEnd_Get parameters: - name: Comment @@ -2503,7 +2503,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns events from the hub within the date range defined by the StartUtc and End path parameters. Supply additional filters and pagination options in the request body. operationId: GetEventsstartStartUtcendEnd_Post requestBody: content: @@ -2527,7 +2527,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns a paginated list of events from the hub using the Skip and Take values specified in the path. Use this endpoint to retrieve specific result pages without relying on query string pagination parameters. operationId: GetEventsskipSkiptakeTake_Get parameters: - name: Comment @@ -2704,7 +2704,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns a paginated list of events from the hub using the Skip and Take values specified in the path. Supply additional filter options in the request body. operationId: GetEventsskipSkiptakeTake_Post requestBody: content: @@ -2728,7 +2728,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns a filtered list of events from the hub service. Use the query parameters to scope results by device, event type, time range, or status. Supply a TimeZoneId to receive times converted to the caller's local time zone. operationId: GetEventsEventId_Get parameters: - name: Comment @@ -2905,7 +2905,7 @@ paths: tags: - events summary: Retrieve events from hub - description: Retrieves a list of events from the hub service. + description: Returns a filtered list of events from the hub service using a POST body. Use this form when the query parameters would exceed URL length limits. Supply a TimeZoneId in the body to receive times converted to the caller's local time zone. operationId: GetEventsEventId_Post requestBody: content: @@ -2929,7 +2929,7 @@ paths: tags: - alertEvents summary: Submit alert events - description: Adds a list of alert events to the system. + description: Submits a list of alert events to the hub for processing. Use this endpoint to send alert notifications from agents or external sources. Returns 204 No Content on success. operationId: SubmitAlertEventsadd_Get parameters: - name: Events @@ -2958,7 +2958,7 @@ paths: tags: - alertEvents summary: Submit alert events - description: Adds a list of alert events to the system. + description: Submits a list of alert events to the hub for processing using a POST body. Use this form to send alert event payloads that are too large for a query string. Returns 204 No Content on success. operationId: SubmitAlertEventsadd_Post requestBody: content: @@ -2980,7 +2980,7 @@ paths: tags: - alertEvents summary: Submit alert events with rate limiting - description: Adds a list of alert events to the system. The response can indicate a rate-limiting back off time. + description: Submits a list of alert events to the hub and applies rate limiting. If the hub is processing events faster than it can handle, the response includes a back-off time that the caller should wait before sending further events. operationId: SubmitAlertEventsLimitedlimitedAdd_Get parameters: - name: Events @@ -3011,7 +3011,7 @@ paths: tags: - alertEvents summary: Submit alert events with rate limiting - description: Adds a list of alert events to the system. The response can indicate a rate-limiting back off time. + description: Submits a list of alert events to the hub using a POST body and applies rate limiting. The response includes a back-off interval when the hub signals that the caller should slow its submission rate. operationId: SubmitAlertEventsLimitedlimitedAdd_Post requestBody: content: @@ -3035,7 +3035,7 @@ paths: tags: - baselineEvents summary: Submit baseline events - description: Adds a list of baseline events to the system. + description: Submits a list of baseline events to the hub for processing. Use this endpoint to record baseline snapshots captured by agents. Returns 204 No Content on success. operationId: SubmitBaselineEventsadd_Get parameters: - name: Events @@ -3064,7 +3064,7 @@ paths: tags: - baselineEvents summary: Submit baseline events - description: Adds a list of baseline events to the system. + description: Submits a list of baseline events to the hub for processing using a POST body. Use this form when the event payload is too large for a query string. Returns 204 No Content on success. operationId: SubmitBaselineEventsadd_Post requestBody: content: @@ -3086,7 +3086,7 @@ paths: tags: - baselineEvents summary: Submit baseline events with rate limiting - description: Adds a list of baseline events to the system. The response can indicate a rate-limiting back off time. + description: Submits a list of baseline events to the hub and applies rate limiting. If the hub signals that the submission rate is too high, the response includes a back-off interval that the caller should respect before sending more events. operationId: SubmitBaselineEventsLimitedlimitedAdd_Get parameters: - name: Events @@ -3117,7 +3117,7 @@ paths: tags: - baselineEvents summary: Submit baseline events with rate limiting - description: Adds a list of baseline events to the system. The response can indicate a rate-limiting back off time. + description: Submits a list of baseline events to the hub using a POST body and applies rate limiting. The response includes a back-off interval when the hub signals that the caller should reduce its submission rate. operationId: SubmitBaselineEventsLimitedlimitedAdd_Post requestBody: content: @@ -3141,7 +3141,7 @@ paths: tags: - deviceEvents summary: Submit device change events - description: Adds a list of device change events to the system. + description: Submits a list of device change events to the hub for processing. Use this endpoint when agents report detected changes on monitored devices. Returns 204 No Content on success. operationId: SubmitDeviceEventsadd_Get parameters: - name: Events @@ -3170,7 +3170,7 @@ paths: tags: - deviceEvents summary: Submit device change events - description: Adds a list of device change events to the system. + description: Submits a list of device change events to the hub for processing using a POST body. Use this form when the event payload is too large for a query string. Returns 204 No Content on success. operationId: SubmitDeviceEventsadd_Post requestBody: content: @@ -3192,7 +3192,7 @@ paths: tags: - deviceEvents summary: Submit device change events with rate limiting - description: Adds a list of device change events to the system. The response can indicate a rate-limiting back off time. + description: Submits a list of device change events to the hub and applies rate limiting. When the hub is under heavy load, the response includes a back-off interval that the caller should wait before submitting further events. operationId: SubmitDeviceEventsLimitedlimitedAdd_Get parameters: - name: Events @@ -3223,7 +3223,7 @@ paths: tags: - deviceEvents summary: Submit device change events with rate limiting - description: Adds a list of device change events to the system. The response can indicate a rate-limiting back off time. + description: Submits a list of device change events to the hub using a POST body and applies rate limiting. The response includes a back-off interval when the hub signals that the caller should slow its event submission rate. operationId: SubmitDeviceEventsLimitedlimitedAdd_Post requestBody: content: @@ -3247,7 +3247,7 @@ paths: tags: - status summary: Get system boot status - description: Gets whether system is booted and ready for login. + description: Returns a value indicating whether the hub system has fully booted and is ready to accept login requests. Use this endpoint to poll hub availability before attempting authentication. operationId: SystemReadyready_Get parameters: - name: Version @@ -3268,7 +3268,7 @@ paths: tags: - status summary: Get system boot status - description: Gets whether system is booted and ready for login. + description: Returns a value indicating whether the hub system has fully booted and is ready to accept login requests. Use this POST form when a GET request is not appropriate for the calling environment. operationId: SystemReadyready_Post requestBody: content: @@ -3290,7 +3290,7 @@ paths: tags: - status summary: Get system version and config - description: Gets system version and config settings once logged in. + description: Returns the hub system version and key configuration settings. Call this endpoint after authentication to verify the hub version and capabilities available to the current session. operationId: SystemDetailssystem_Get parameters: - name: Version @@ -3313,7 +3313,7 @@ paths: tags: - status summary: Get system version and config - description: Gets system version and config settings once logged in. + description: Returns the hub system version and key configuration settings using a POST body. Use this form when a GET request is not appropriate for the calling environment. operationId: SystemDetailssystem_Post requestBody: content: @@ -3337,7 +3337,7 @@ paths: tags: - status summary: 'List background task statuses' - description: 'Retrieves a list of background, potentially long-running, tasks the hub has performed and their associated status.' + description: 'Returns a list of background tasks the hub has performed, along with their current status. Filter results by user, time range, task type, or specific task IDs. Admin users can retrieve tasks for other users or internal system operations.' operationId: GetBackgroundTaskStatusesbackgroundtasks_Get parameters: - name: UserName @@ -3411,7 +3411,7 @@ paths: tags: - status summary: 'List background task statuses' - description: 'Retrieves a list of background, potentially long-running, tasks the hub has performed and their associated status.' + description: 'Returns a list of background tasks the hub has performed, along with their current status, using a POST body. Filter results by user, time range, task type, or specific task IDs.' operationId: GetBackgroundTaskStatusesbackgroundtasks_Post requestBody: content: @@ -3438,7 +3438,7 @@ paths: tags: - status summary: Events in processing queue - description: Gets the number of events currently in the processing queue. + description: Returns the count of events currently waiting in the hub's incoming processing queue. Use this value to monitor queue depth and assess processing backlog. operationId: EventsOnIncomingQueueeventsOnIncomingQueue_Get parameters: - name: Version @@ -3463,7 +3463,7 @@ paths: tags: - status summary: Events in processing queue - description: Gets the number of events currently in the processing queue. + description: Returns the count of events currently waiting in the hub's incoming processing queue using a POST body. Use this value to monitor queue depth and assess processing backlog. operationId: EventsOnIncomingQueueeventsOnIncomingQueue_Post requestBody: content: @@ -3489,7 +3489,7 @@ paths: tags: - status summary: 'Count internal event notifications' - description: 'Returns the number of internal event notification messages received, processed or failed.' + description: 'Returns a dictionary of internal event notification message counters, showing the number of messages received, successfully processed, and failed. Use this endpoint to diagnose event processing health.' operationId: EventMessageStatusmessageStatus_Get parameters: - name: Version @@ -3516,7 +3516,7 @@ paths: tags: - status summary: 'Count internal event notifications' - description: 'Returns the number of internal event notification messages received, processed or failed.' + description: 'Returns a dictionary of internal event notification message counters, showing the number of messages received, successfully processed, and failed, using a POST body.' operationId: EventMessageStatusmessageStatus_Post requestBody: content: @@ -3544,7 +3544,7 @@ paths: tags: - status summary: 'Get pipeline component statuses' - description: 'Gets the pipeline status, returning a dictionary of pipeline components and their current status.' + description: 'Returns the current operational status of each pipeline component as a key-value map. Possible component statuses include Unknown, Starting, Up, Stopping, Down, Busy, Fault, and RequiresUpgrade.' operationId: GetPipelineStatuspipeline_Get parameters: - name: Version @@ -3580,7 +3580,7 @@ paths: tags: - status summary: 'Get pipeline component statuses' - description: 'Gets the pipeline status, returning a dictionary of pipeline components and their current status.' + description: 'Returns the current operational status of each pipeline component as a key-value map using a POST body. Possible component statuses include Unknown, Starting, Up, Stopping, Down, Busy, Fault, and RequiresUpgrade.' operationId: GetPipelineStatuspipeline_Post requestBody: content: @@ -3617,7 +3617,7 @@ paths: tags: - status summary: Gets system performance metrics. - description: Gets system performance metrics. + description: Returns a list of performance snapshots for the hub pipeline. Use this endpoint to monitor throughput, latency, and resource utilization over time. operationId: GetPipelineMetricspipelineMetrics_Get parameters: - name: Version @@ -3643,7 +3643,7 @@ paths: tags: - status summary: Gets system performance metrics. - description: Gets system performance metrics. + description: Returns a list of performance snapshots for the hub pipeline using a POST body. Use this endpoint to monitor throughput, latency, and resource utilization over time. operationId: GetPipelineMetricspipelineMetrics_Post requestBody: content: @@ -3670,7 +3670,7 @@ paths: tags: - status summary: Returns the pipeline workload. - description: Returns the pipeline workload. + description: Returns a dictionary of pipeline workload metrics, each expressed as a numeric value. Use this endpoint to assess the current processing load on individual pipeline stages. operationId: GetWorkloadStatsworkload_Get parameters: - name: Version @@ -3699,7 +3699,7 @@ paths: tags: - status summary: Returns the pipeline workload. - description: Returns the pipeline workload. + description: Returns a dictionary of pipeline workload metrics using a POST body. Use this endpoint to assess the current processing load on individual pipeline stages. operationId: GetWorkloadStatsworkload_Post requestBody: content: @@ -3729,7 +3729,7 @@ paths: tags: - status summary: Returns the cache statistics. - description: Returns the cache statistics. + description: Returns statistics for the hub's internal cache, including hit rates and entry counts. Use this endpoint to diagnose caching performance or confirm that cache invalidation has taken effect. operationId: GetCacheStatscache_Get parameters: - name: Version @@ -3752,7 +3752,7 @@ paths: tags: - status summary: Returns the cache statistics. - description: Returns the cache statistics. + description: Returns statistics for the hub's internal cache using a POST body, including hit rates and entry counts. Use this endpoint to diagnose caching performance or confirm that cache invalidation has taken effect. operationId: GetCacheStatscache_Post requestBody: content: @@ -3790,7 +3790,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns the list of report types available on this hub. Use the returned type identifiers when creating new scheduled reports with the AddScheduledReport endpoint. operationId: GetAvailableReportTypesavailableTypes_Get parameters: - name: Version @@ -3813,7 +3813,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns the list of report types available on this hub using a POST body. Use the returned type identifiers when creating new scheduled reports with the AddScheduledReport endpoint. operationId: GetAvailableReportTypesavailableTypes_Post requestBody: content: @@ -3837,7 +3837,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns the raw content of a report layout template. Use this endpoint to retrieve a template for inspection or as the basis for a customized version. operationId: GetReportTemplatetemplate_Get parameters: - name: Version @@ -3861,7 +3861,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns the raw content of a report layout template using a POST body. Use this endpoint to retrieve a template for inspection or as the basis for a customized version. operationId: GetReportTemplatetemplate_Post requestBody: content: @@ -3886,7 +3886,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns a list of all available report layout templates. Use the returned template names and versions when selecting a layout for report rendering or when managing custom templates. operationId: GetReportTemplatestemplates_Get parameters: - name: Version @@ -3909,7 +3909,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns a list of all available report layout templates using a POST body. Use the returned template names and versions when selecting a layout for report rendering or when managing custom templates. operationId: GetReportTemplatestemplates_Post requestBody: content: @@ -3933,7 +3933,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns the list of currently configured scheduled reports. The response lists each report's current state including its schedule, visibility settings, and last execution details. operationId: GetScheduledReportsscheduled_Get parameters: - name: Version @@ -3956,7 +3956,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns the list of currently configured scheduled reports using a POST body. The response lists each report's current state including its schedule, visibility settings, and last execution details. operationId: GetScheduledReportsscheduled_Post requestBody: content: @@ -3980,7 +3980,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Updates an existing report layout template on the hub. Use this endpoint to push a revised template definition and replace the current version. operationId: UpdateReportTemplateupdatetemplate_Get parameters: - name: Version @@ -4003,7 +4003,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Updates an existing report layout template on the hub using a POST body. Use this endpoint to push a revised template definition and replace the current version. operationId: UpdateReportTemplateupdatetemplate_Post requestBody: content: @@ -4027,7 +4027,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Uploads a new custom report layout template to the hub. Returns 204 No Content on success. Use this endpoint to deploy bespoke report templates that are then available for selection when rendering reports. operationId: UploadReportTemplateuploadreporttemplate_Post requestBody: content: @@ -4049,7 +4049,7 @@ paths: tags: - reports summary: Delete report layout template - description: Deletes a report layout template of the specified type and name + description: Permanently removes a custom report layout template identified by its type, name, and version. This operation cannot be undone, so ensure the correct template is targeted before calling this endpoint. operationId: DeleteCustomReportTemplatedeletecustomreporttemplate_Get parameters: - name: ReportTemplateType @@ -4101,7 +4101,7 @@ paths: tags: - reports summary: Delete report layout template - description: Deletes a report layout template of the specified type and name + description: Permanently removes a custom report layout template identified by its type, name, and version using a POST body. This operation cannot be undone, so ensure the correct template is targeted before calling this endpoint. operationId: DeleteCustomReportTemplatedeletecustomreporttemplate_Post requestBody: content: @@ -4123,7 +4123,7 @@ paths: tags: - reports summary: Get device monitoring report data - description: A request to gets the data for a device monitoring report + description: Returns the data required to populate a device monitoring report. Filter results by device group, online status, or a date range. Use the Groups parameter to limit results to specific device groups and their children. operationId: DataSpecDeviceMonitoringReportdevicemonitoring_Get parameters: - name: DateRange @@ -4202,7 +4202,7 @@ paths: tags: - reports summary: Get device monitoring report data - description: A request to gets the data for a device monitoring report + description: Returns the data required to populate a device monitoring report using a POST body. Filter results by device group, online status, or a date range. Use the Groups parameter to limit results to specific device groups and their children. operationId: DataSpecDeviceMonitoringReportdevicemonitoring_Post requestBody: content: @@ -4324,7 +4324,7 @@ paths: tags: - stats summary: Stats Service - description: Stats Service + description: Returns a paginated list of planned changes currently active on the hub. Use the sort and pagination parameters to control ordering and page size of the returned results. operationId: GetCurrentPlannedChangesplannedChanges_Get parameters: - name: CountOnly @@ -4387,7 +4387,7 @@ paths: tags: - stats summary: Stats Service - description: Stats Service + description: Returns a paginated list of currently active planned changes using a POST body. Use the sort and pagination parameters to control ordering and page size of the returned results. operationId: GetCurrentPlannedChangesplannedChanges_Post requestBody: content: @@ -4411,7 +4411,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Returns compliance report summary data for a scheduled report item. Results include per-device scores or group-average scores depending on the report configuration. Use the pagination parameters to page through large result sets.' operationId: GetComplianceDatacompliancedata_Get parameters: - name: ReportItemId @@ -4480,7 +4480,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Returns compliance report summary data for a scheduled report item using a POST body. Results include per-device scores or group-average scores depending on the report configuration.' operationId: GetComplianceDatacompliancedata_Post requestBody: content: @@ -4504,7 +4504,7 @@ paths: tags: - stats summary: List groups with available report data - description: Get a list of groups or devices that have report data available for them + description: Returns a list of groups and devices for which compliance report data is currently available. Use this endpoint to determine which entities can be queried before requesting compliance summary data. operationId: GetAvailableComplianceDatagetavailablecompliancedata_Get parameters: - name: Version @@ -4527,7 +4527,7 @@ paths: tags: - stats summary: List groups with available report data - description: Get a list of groups or devices that have report data available for them + description: Returns a list of groups and devices for which compliance report data is currently available using a POST body. Use this endpoint to determine which entities can be queried before requesting compliance summary data. operationId: GetAvailableComplianceDatagetavailablecompliancedata_Post requestBody: content: @@ -4551,7 +4551,7 @@ paths: tags: - stats summary: List inactive devices by filter - description: Gets a list of inactive devices matching the filter. + description: Returns a list of devices that have been inactive within the specified time period. The response identifies devices that have not reported activity and includes criteria matched by the filter provided in the request. operationId: GetDeviceActivitydeviceActivity_Get parameters: - name: Version @@ -4574,7 +4574,7 @@ paths: tags: - stats summary: List inactive devices by filter - description: Gets a list of inactive devices matching the filter. + description: Returns a list of devices that have been inactive within the specified time period using a POST body. The response identifies devices that have not reported activity and includes criteria matched by the filter. operationId: GetDeviceActivitydeviceActivity_Post requestBody: content: @@ -4598,7 +4598,7 @@ paths: tags: - stats summary: 'Get event counts by device filter' - description: 'Gets a summary of event counts for the devices or groups specified by the DeviceFilter, for the specified time period.' + description: 'Returns a summary of event counts for the devices or groups identified by the DeviceFilter over the specified time period. Use the pagination and sort parameters to page through results or order them by a specific field.' operationId: GetEventCountsevents_Get parameters: - name: CountOnly @@ -4661,7 +4661,7 @@ paths: tags: - stats summary: 'Get event counts by device filter' - description: 'Gets a summary of event counts for the devices or groups specified by the DeviceFilter, for the specified time period.' + description: 'Returns a summary of event counts for the devices or groups identified by the DeviceFilter over the specified time period, using a POST body. Use the pagination and sort parameters to page through results or order them by a specific field.' operationId: GetEventCountsevents_Post requestBody: content: @@ -4685,7 +4685,7 @@ paths: tags: - stats summary: 'Get noisy device event counts' - description: 'Gets a summary of event counts for top N noisiest devices in the specified group, for the specified time period.' + description: 'Returns event count summaries for the top N devices generating the most events in the specified group over the given time period. Use this endpoint to identify high-activity or problematic devices that may warrant investigation.' operationId: GetNoisyDevicesnoisydevices_Get parameters: - name: TopN @@ -4710,7 +4710,7 @@ paths: tags: - stats summary: 'Get noisy device event counts' - description: 'Gets a summary of event counts for top N noisiest devices in the specified group, for the specified time period.' + description: 'Returns event count summaries for the top N devices generating the most events in the specified group over the given time period, using a POST body. Use this endpoint to identify high-activity or problematic devices that may warrant investigation.' operationId: GetNoisyDevicesnoisydevices_Post parameters: - name: TopN @@ -4744,7 +4744,7 @@ paths: tags: - reportExecute summary: Report Service - description: Report Service + description: Triggers execution of the specified scheduled report and returns the result. Provide the ReportItemId to identify which report to run. The response includes the rendered output or a reference to the result depending on the report type. operationId: ExecuteReport_Get parameters: - name: ReportItemId @@ -4773,7 +4773,7 @@ paths: tags: - reportExecute summary: Report Service - description: Report Service + description: Triggers execution of the specified scheduled report using a POST body and returns the result. Provide the ReportItemId to identify which report to run. operationId: ExecuteReport_Post requestBody: content: @@ -4797,7 +4797,7 @@ paths: tags: - reportRenderIsCached summary: Report Service - description: Report Service + description: Returns a boolean indicating whether the rendered output for the specified report instance is already available in the cache. Use this check before calling the render endpoint to avoid unnecessary rendering when a cached result exists. operationId: RenderReportIsCached_Get parameters: - name: ReportItemId @@ -4836,7 +4836,7 @@ paths: tags: - reportRenderIsCached summary: Report Service - description: Report Service + description: Returns a boolean indicating whether the rendered output for the specified report instance is already available in the cache, using a POST body. Use this check before calling the render endpoint to avoid unnecessary processing. operationId: RenderReportIsCached_Post requestBody: content: @@ -4861,7 +4861,7 @@ paths: tags: - reportRender summary: Report Service - description: Report Service + description: Renders the specified report instance and returns the rendered output. Provide the ReportItemId and InstanceId to identify the exact instance to render. For compliance reports, you may supply a RuleSetResultEventId instead. operationId: RenderReport_Get parameters: - name: ReportItemId @@ -4902,7 +4902,7 @@ paths: tags: - reportRender summary: Report Service - description: Report Service + description: Renders the specified report instance and returns the rendered output using a POST body. Provide the ReportItemId and InstanceId to identify the exact instance to render. operationId: RenderReport_Post requestBody: content: @@ -4927,7 +4927,7 @@ paths: tags: - reportRenderStart summary: Report Service - description: Report Service + description: Initiates an asynchronous render of the specified report instance and returns a task reference. Use this endpoint when rendering may take a significant amount of time; poll the background task status endpoint to check for completion. operationId: RenderReportStart_Get parameters: - name: ReportItemId @@ -4968,7 +4968,7 @@ paths: tags: - reportRenderStart summary: Report Service - description: Report Service + description: Initiates an asynchronous render of the specified report instance using a POST body and returns a task reference. Poll the background task status endpoint to check for completion. operationId: RenderReportStart_Post requestBody: content: @@ -4993,7 +4993,7 @@ paths: tags: - reports summary: Get generated report output file - description: Gets a previously generated report output file + description: Downloads a previously generated report output file. Use this endpoint after a report has been rendered and the output saved to retrieve the file content for display or export. operationId: GetScheduledInstanceOutputscheduledinstancesrendereddownload_Get parameters: - name: Version @@ -5017,7 +5017,7 @@ paths: tags: - reports summary: Get generated report output file - description: Gets a previously generated report output file + description: Downloads a previously generated report output file using a POST body. Use this endpoint after a report has been rendered and saved to retrieve the file content for display or export. operationId: GetScheduledInstanceOutputscheduledinstancesrendereddownload_Post requestBody: content: @@ -5042,7 +5042,7 @@ paths: tags: - reports summary: Deletes previously generated report output files - description: Deletes previously generated report output files + description: Permanently removes previously generated report output files from the hub. Use this endpoint to free storage space or to clear stale rendered outputs before regenerating a report. operationId: DeleteScheduledInstanceOutputsscheduledinstancesrendereddelete_Get parameters: - name: Version @@ -5063,7 +5063,7 @@ paths: tags: - reports summary: Deletes previously generated report output files - description: Deletes previously generated report output files + description: Permanently removes previously generated report output files from the hub using a POST body. Use this endpoint to free storage space or to clear stale rendered outputs before regenerating a report. operationId: DeleteScheduledInstanceOutputsscheduledinstancesrendereddelete_Post requestBody: content: @@ -5085,7 +5085,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Permanently deletes a specific scheduled report instance identified by its ReportItemId and InstanceId. This removes the instance record and any associated output from the hub. operationId: DeleteScheduledInstancescheduledinstancesdelete_Get parameters: - name: ReportItemId @@ -5118,7 +5118,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Permanently deletes a specific scheduled report instance identified by its ReportItemId and InstanceId using a POST body. This removes the instance record and any associated output from the hub. operationId: DeleteScheduledInstancescheduledinstancesdelete_Post requestBody: content: @@ -5140,7 +5140,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Updates the retention lifetime of a specific scheduled report instance. Use this endpoint to extend or shorten how long a generated instance is kept before the hub automatically removes it. operationId: UpdateScheduledInstanceLifetimescheduledinstanceupdateLifetime_Get parameters: - name: ReportItemId @@ -5175,7 +5175,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Updates the retention lifetime of a specific scheduled report instance using a POST body. Use this endpoint to extend or shorten how long a generated instance is kept before the hub automatically removes it. operationId: UpdateScheduledInstanceLifetimescheduledinstanceupdateLifetime_Post requestBody: content: @@ -5199,7 +5199,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns information about rendered instances of scheduled reports, including their availability and output locations. Optionally filter by ReportItemId to limit results to a specific report. operationId: GetScheduledInstanceRenderedscheduledinstancesrendered_Get parameters: - name: ReportItemId @@ -5227,7 +5227,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns information about rendered instances of scheduled reports using a POST body, including their availability and output locations. Optionally filter by ReportItemId to limit results to a specific report. operationId: GetScheduledInstanceRenderedscheduledinstancesrendered_Post requestBody: content: @@ -5251,7 +5251,7 @@ paths: tags: - reports summary: Add scheduled report - description: Adds a new schedulable report of the type specified by the Id parameter + description: Creates a new scheduled report of the type identified by the Id parameter. You can optionally create the report as a copy of an existing one using the AsCopyOf parameter. The response lists the updated state of all affected reports. operationId: AddScheduledReportscheduledadd_Get parameters: - name: Id @@ -5303,7 +5303,7 @@ paths: tags: - reports summary: Add scheduled report - description: Adds a new schedulable report of the type specified by the Id parameter + description: Creates a new scheduled report of the type identified by the Id parameter using a POST body. You can optionally create the report as a copy of an existing one using the AsCopyOf parameter. The response lists the updated state of all affected reports. operationId: AddScheduledReportscheduledadd_Post requestBody: content: @@ -5327,7 +5327,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Updates the settings of an existing scheduled report, including its schedule, sub-reports, email delivery options, and visibility flags. The response lists the updated state of all affected reports. operationId: UpdateScheduledReportscheduledupdate_Get parameters: - name: ShowTableOfContents @@ -5428,7 +5428,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Updates the settings of an existing scheduled report using a POST body, including its schedule, sub-reports, email delivery options, and visibility flags. The response lists the updated state of all affected reports. operationId: UpdateScheduledReportscheduledupdate_Post requestBody: content: @@ -5452,7 +5452,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Permanently removes one or more scheduled reports from the hub. Returns a boolean indicating whether the deletion was successful. operationId: DeleteScheduledReportsscheduleddelete_Get parameters: - name: Version @@ -5476,7 +5476,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Permanently removes one or more scheduled reports from the hub using a POST body. Returns a boolean indicating whether the deletion was successful. operationId: DeleteScheduledReportsscheduleddelete_Post requestBody: content: @@ -5501,7 +5501,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns information about one or more scheduled report instances. Provide both a ReportItemId and an InstanceId to retrieve a specific instance. Use SummaryOnly to limit the response to summary fields for display in a reporting UI. operationId: GetScheduledInstancesscheduledinstances_Get parameters: - name: SummaryOnly @@ -5542,7 +5542,7 @@ paths: tags: - reports summary: Report Service - description: Report Service + description: Returns information about one or more scheduled report instances using a POST body. Provide both a ReportItemId and an InstanceId to retrieve a specific instance. Use SummaryOnly to limit the response to summary fields. operationId: GetScheduledInstancesscheduledinstances_Post requestBody: content: @@ -5566,7 +5566,7 @@ paths: tags: - uploadAgentUpdate summary: Upload an Agent Update - description: Upload an Agent Update + description: Uploads an agent software update package to the hub, making it available for distribution to agents. Returns 204 No Content on success. operationId: UploadAgentUpdate_Get parameters: - name: Version @@ -5587,7 +5587,7 @@ paths: tags: - uploadAgentUpdate summary: Upload an Agent Update - description: Upload an Agent Update + description: Uploads an agent software update package to the hub using a POST body, making it available for distribution to agents. Returns 204 No Content on success. operationId: UploadAgentUpdate_Post requestBody: content: @@ -5609,7 +5609,7 @@ paths: tags: - updatehubdetails summary: Update HubDetails.xml for agents/groups - description: Update the HUbDetails.xml file for the specified agents / groups + description: Updates the HubDetails.xml configuration file for the specified agents or groups. This file contains hub connection information that agents use to communicate with the hub. operationId: UpdateHubDetails_Get parameters: - name: Version @@ -5630,7 +5630,7 @@ paths: tags: - updatehubdetails summary: Update HubDetails.xml for agents/groups - description: Update the HUbDetails.xml file for the specified agents / groups + description: Updates the HubDetails.xml configuration file for the specified agents or groups using a POST body. This file contains hub connection information that agents use to communicate with the hub. operationId: UpdateHubDetails_Post requestBody: content: @@ -5652,7 +5652,7 @@ paths: tags: - downloadAgentUpdate summary: Download agent update package - description: Download an update package for the agent. + description: Downloads an agent software update package for the requested version. Specify the VersionRequested path parameter and the UpdateType (for example, Windows, LinuxRPM, or UbuntuDEB) to receive the appropriate platform package. operationId: DownloadUpdateVersionRequested_Get parameters: - name: VersionRequested @@ -5703,7 +5703,7 @@ paths: tags: - downloadAgentUpdate summary: Download agent update package - description: Download an update package for the agent. + description: Downloads an agent software update package for the requested version using a POST body. Specify the version and UpdateType to receive the appropriate platform package. operationId: DownloadUpdateVersionRequested_Post requestBody: content: @@ -5727,7 +5727,7 @@ paths: tags: - downloadAgentUpdate summary: Download agent update package - description: Download an update package for the agent. + description: Downloads an agent software update package for the requested version and update type supplied as path parameters. The UpdateType value selects the platform-specific package, such as Windows, LinuxRPM, or UbuntuDEB. operationId: DownloadUpdateVersionRequestedUpdateType_Get parameters: - name: VersionRequested @@ -5778,7 +5778,7 @@ paths: tags: - downloadAgentUpdate summary: Download agent update package - description: Download an update package for the agent. + description: Downloads an agent software update package for the requested version and update type supplied as path parameters, using a POST body. The UpdateType value selects the platform-specific package. operationId: DownloadUpdateVersionRequestedUpdateType_Post requestBody: content: @@ -5802,7 +5802,7 @@ paths: tags: - agentUpdates summary: Deletes the specified Agent update. - description: Deletes the specified Agent update. + description: Permanently removes the specified agent update package from the hub. Provide the Id of the agent update to delete. Returns 204 No Content on success. operationId: DeleteAgentUpdatedelete_Get parameters: - name: Id @@ -5828,7 +5828,7 @@ paths: tags: - agentUpdates summary: Deletes the specified Agent update. - description: Deletes the specified Agent update. + description: Permanently removes the specified agent update package from the hub using a POST body. Provide the Id of the agent update to delete. Returns 204 No Content on success. operationId: DeleteAgentUpdatedelete_Post requestBody: content: @@ -5850,7 +5850,7 @@ paths: tags: - agentUpdates summary: 'List agent updates' - description: 'Gets a list of Agent updates, by version or specific ID.' + description: 'Returns a list of agent software updates available on the hub, optionally filtered by version, specific ID, or update type (for example, deb, rpm, or Windows). Use this endpoint to discover which update packages are available before triggering a deployment.' operationId: GetAgentUpdates_Get parameters: - name: VersionRequested @@ -5909,7 +5909,7 @@ paths: tags: - agentUpdates summary: 'List agent updates' - description: 'Gets a list of Agent updates, by version or specific ID.' + description: 'Returns a list of agent software updates available on the hub using a POST body, optionally filtered by version, specific ID, or update type. Use this endpoint to discover which update packages are available before triggering a deployment.' operationId: GetAgentUpdates_Post requestBody: content: @@ -5936,7 +5936,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Get group agent update schedule - description: Gets the agent software update schedule for a group. + description: Returns the agent software update schedule configured for the specified group. Use the GroupName parameter to identify the group whose schedule you want to retrieve. operationId: GetAgentSoftwareUpdateScheduleForGroup_Get parameters: - name: GroupName @@ -5967,7 +5967,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Get group agent update schedule - description: Gets the agent software update schedule for a group. + description: Returns the agent software update schedule configured for the specified group using a POST body. Use the GroupName parameter to identify the group whose schedule you want to retrieve. operationId: GetAgentSoftwareUpdateScheduleForGroup_Post requestBody: content: @@ -5994,7 +5994,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Remove group agent update schedule - description: Remove (delete) the agent software update schedule for a group. + description: Removes the agent software update schedule for the specified group. Use the GroupName parameter to identify the group whose schedule you want to delete. Returns 204 No Content on success. operationId: DeleteAgentSoftwareUpdateScheduleFromGroupdelete_Get parameters: - name: GroupName @@ -6020,7 +6020,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Remove group agent update schedule - description: Remove (delete) the agent software update schedule for a group. + description: Removes the agent software update schedule for the specified group using a POST body. Use the GroupName parameter to identify the group whose schedule you want to delete. Returns 204 No Content on success. operationId: DeleteAgentSoftwareUpdateScheduleFromGroupdelete_Post requestBody: content: @@ -6042,7 +6042,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Update group agent update schedule - description: Update the agent software update schedule for a group. + description: Updates the agent software update schedule for the specified group. Provide both the GroupName and a new AgentUpdateSchedule definition to replace the existing schedule. Returns 204 No Content on success. operationId: UpdateAgentSoftwareUpdateScheduleForGroupupdate_Get parameters: - name: GroupName @@ -6073,7 +6073,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Update group agent update schedule - description: Update the agent software update schedule for a group. + description: Updates the agent software update schedule for the specified group using a POST body. Provide both the GroupName and a new AgentUpdateSchedule definition to replace the existing schedule. Returns 204 No Content on success. operationId: UpdateAgentSoftwareUpdateScheduleForGroupupdate_Post requestBody: content: @@ -6095,7 +6095,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Set agent update schedule for group - description: Add (set) an agent update schedule for a specific group. Only one schedule is permitted per group at the current time. + description: Adds an agent software update schedule for the specified group. Only one schedule is permitted per group at a time, so use the update endpoint if a schedule already exists. Returns the full list of schedules for the group on success. operationId: SetAgentSoftwareUpdateScheduleForGroupadd_Get parameters: - name: GroupName @@ -6131,7 +6131,7 @@ paths: tags: - agentSoftwareUpdateSchedules summary: Set agent update schedule for group - description: Add (set) an agent update schedule for a specific group. Only one schedule is permitted per group at the current time. + description: Adds an agent software update schedule for the specified group using a POST body. Only one schedule is permitted per group at a time. Returns the full list of schedules for the group on success. operationId: SetAgentSoftwareUpdateScheduleForGroupadd_Post requestBody: content: @@ -6158,7 +6158,7 @@ paths: tags: - syncServiceConfigItems summary: List SyncService configuration items - description: Retrieves a list of SyncService configuration items. + description: Returns a paginated list of SyncService configuration items stored on the hub. Use the sort and pagination parameters to control ordering and page size, and GenericFilters to apply additional filtering criteria. operationId: GetSyncServiceConfigItems_Get parameters: - name: CountOnly @@ -6221,7 +6221,7 @@ paths: tags: - syncServiceConfigItems summary: List SyncService configuration items - description: Retrieves a list of SyncService configuration items. + description: Returns a paginated list of SyncService configuration items stored on the hub using a POST body. Use the sort and pagination parameters to control ordering and page size. operationId: GetSyncServiceConfigItems_Post requestBody: content: @@ -6245,7 +6245,7 @@ paths: tags: - syncServiceConfigItems summary: Adds a new SyncService configuration item. - description: Adds a new SyncService configuration item. + description: Creates a new SyncService configuration item on the hub. Returns the newly created item, including its assigned ID, in the response. operationId: AddSyncServiceConfigItemadd_Post requestBody: content: @@ -6269,7 +6269,7 @@ paths: tags: - syncServiceConfigItems summary: Updates an existing SyncService configuration item. - description: Updates an existing SyncService configuration item. + description: Updates an existing SyncService configuration item identified by its ID. Provide the updated field values in the request body. Returns the updated item on success. operationId: UpdateSyncServiceConfigItemupdate_Post requestBody: content: @@ -6293,7 +6293,7 @@ paths: tags: - syncServiceConfigItems summary: Deletes a SyncService configuration item. - description: Deletes a SyncService configuration item. + description: Permanently removes a SyncService configuration item from the hub. Provide the item ID in the request body to identify which item to delete. operationId: DeleteSyncServiceConfigItemdelete_Post requestBody: content: @@ -6317,7 +6317,7 @@ paths: tags: - configItems summary: List hub configuration parameters - description: Retrieves a list of hub configuration parameters. + description: Returns a list of hub configuration parameters, optionally filtered by ID, Key, or a list of Keys. Include hidden system parameters by setting IncludeHidden to true. Use the pagination and sort parameters to page through large result sets. operationId: GetConfigItems_Get parameters: - name: Id @@ -6404,7 +6404,7 @@ paths: tags: - configItems summary: List hub configuration parameters - description: Retrieves a list of hub configuration parameters. + description: Returns a list of hub configuration parameters using a POST body, optionally filtered by ID or Key. Use the pagination and sort parameters to page through large result sets. operationId: GetConfigItems_Post requestBody: content: @@ -6428,7 +6428,7 @@ paths: tags: - configItems summary: Add hub config parameters - description: Add a list of hub configuration parameters. + description: Adds multiple hub configuration parameters in a single bulk operation. Supply the key-value pairs as a dictionary. Returns a map of keys to the assigned IDs for each newly created configuration item. operationId: AddConfigItemsadd_Get parameters: - name: ConfigItems @@ -6464,7 +6464,7 @@ paths: tags: - configItems summary: Add hub config parameters - description: Add a list of hub configuration parameters. + description: Adds multiple hub configuration parameters in a single bulk operation using a POST body. Returns a map of keys to the assigned IDs for each newly created configuration item. operationId: AddConfigItemsadd_Post requestBody: content: @@ -6492,7 +6492,7 @@ paths: tags: - configItems summary: Update hub config parameters - description: Update a a list of hub configuration parameters. + description: Updates one or more hub configuration parameters in a single bulk operation. Provide a list of ConfigItem objects with the ID and new value for each parameter to update. Returns 204 No Content on success. operationId: UpdateConfigItemsupdate_Get parameters: - name: ConfigItems @@ -6521,7 +6521,7 @@ paths: tags: - configItems summary: Update hub config parameters - description: Update a a list of hub configuration parameters. + description: Updates one or more hub configuration parameters in a single bulk operation using a POST body. Provide a list of ConfigItem objects with the ID and new value for each parameter. Returns 204 No Content on success. operationId: UpdateConfigItemsupdate_Post requestBody: content: @@ -6543,7 +6543,7 @@ paths: tags: - configItems summary: Remove hub config by ID - description: Remove a hub configuration parameter by either ID or Key. + description: Permanently removes a hub configuration parameter identified by its ID or Key. When removing by Key, all configuration items sharing that key are deleted. Returns 204 No Content on success. operationId: DeleteConfigItemdelete_Get parameters: - name: Id @@ -6574,7 +6574,7 @@ paths: tags: - configItems summary: Remove hub config by ID - description: Remove a hub configuration parameter by either ID or Key. + description: Permanently removes a hub configuration parameter identified by its ID or Key using a POST body. When removing by Key, all configuration items sharing that key are deleted. Returns 204 No Content on success. operationId: DeleteConfigItemdelete_Post requestBody: content: @@ -6596,7 +6596,7 @@ paths: tags: - configItem summary: Update config by ID or key - description: Update a single hub configuration parameter by either ID or Key. + description: Updates a single hub configuration parameter identified by either its ID or Key. You can change the Key name, the Value, or the hidden status in a single call. Returns 204 No Content on success. operationId: UpdateConfigItemupdate_Get parameters: - name: Id @@ -6637,7 +6637,7 @@ paths: tags: - configItem summary: Update config by ID or key - description: Update a single hub configuration parameter by either ID or Key. + description: Updates a single hub configuration parameter identified by either its ID or Key using a POST body. You can change the Key name, the Value, or the hidden status in a single call. Returns 204 No Content on success. operationId: UpdateConfigItemupdate_Post requestBody: content: @@ -6659,7 +6659,7 @@ paths: tags: - configItem summary: Add hub config by Key - description: Add a hub configuration parameter by Key. + description: Adds a single hub configuration parameter with the specified Key and Value. Set Hidden to true to mark the parameter as an internal system setting not intended for end-user modification. Returns the newly assigned ID on success. operationId: AddConfigItemadd_Get parameters: - name: Key @@ -6698,7 +6698,7 @@ paths: tags: - configItem summary: Add hub config by Key - description: Add a hub configuration parameter by Key. + description: Adds a single hub configuration parameter with the specified Key and Value using a POST body. Set Hidden to true to mark the parameter as an internal system setting. Returns the newly assigned ID on success. operationId: AddConfigItemadd_Post requestBody: content: @@ -6722,7 +6722,7 @@ paths: tags: - misc summary: Echo date/time serialization test - description: Echos the specified date/time value to ensure that no serialization issues exist between hub and client. + description: Echoes the specified date/time value back to the caller without modification. Use this endpoint to verify that date and time values are serialized and deserialized correctly between the hub and your client, with no loss of precision. operationId: DateTransmissionTestdateTransmissionTest_Get parameters: - name: DateTime @@ -6754,7 +6754,7 @@ paths: tags: - misc summary: Echo date/time serialization test - description: Echos the specified date/time value to ensure that no serialization issues exist between hub and client. + description: Echoes the specified date/time value back to the caller using a POST body. Use this endpoint to verify that date and time values are serialized and deserialized correctly between the hub and your client, with no loss of precision. operationId: DateTransmissionTestdateTransmissionTest_Post requestBody: content: @@ -6780,7 +6780,7 @@ paths: tags: - credentials summary: Add credentials for type and key. - description: Add credentials for specified type and key. + description: Adds a set of credentials for the specified type and key to the hub. Supported credential types include Shell, Database, FTP, Cloud, ESX, ITSM, and Splunk. Returns the created credentials object on success. operationId: AddCredentialsadd_Get parameters: - name: Credentials @@ -6808,7 +6808,7 @@ paths: tags: - credentials summary: Add credentials for type and key. - description: Add credentials for specified type and key. + description: Adds a set of credentials for the specified type and key to the hub using a POST body. Returns the created credentials object on success. operationId: AddCredentialsadd_Post requestBody: content: @@ -6832,7 +6832,7 @@ paths: tags: - credentials summary: Update credentials by type and key. - description: Update credentials for specified type and key. + description: Updates an existing set of credentials on the hub, identified by the original CredentialsType and Key. Supply the updated Credentials object to replace the stored values. Returns the updated credentials on success. operationId: UpdateCredentialsupdate_Get parameters: - name: CredentialsType @@ -6880,7 +6880,7 @@ paths: tags: - credentials summary: Update credentials by type and key. - description: Update credentials for specified type and key. + description: Updates an existing set of credentials on the hub using a POST body, identified by the original CredentialsType and Key. Returns the updated credentials on success. operationId: UpdateCredentialsupdate_Post requestBody: content: @@ -6904,7 +6904,7 @@ paths: tags: - credentials summary: Remove credentials by type and key - description: Remove credentials for specified type and key. + description: Permanently removes the credentials for the specified CredentialsType and Key from the hub. Returns 204 No Content on success. This action cannot be undone. operationId: RemoveCredentialsdelete_Get parameters: - name: CredentialsType @@ -6945,7 +6945,7 @@ paths: tags: - credentials summary: Remove credentials by type and key - description: Remove credentials for specified type and key. + description: Permanently removes the credentials for the specified CredentialsType and Key from the hub using a POST body. Returns 204 No Content on success. This action cannot be undone. operationId: RemoveCredentialsdelete_Post requestBody: content: @@ -6967,7 +6967,7 @@ paths: tags: - credentialsKeyedByType summary: 'List credentials by type' - description: 'Get a list of all the known credentials, keyed by the type.' + description: 'Returns a dictionary of all credentials stored on the hub, organized by credential type. Each key in the response is a credential type (such as Shell or Database), and the value is the list of credential keys of that type.' operationId: GetCredentialsKeyedByType_Get parameters: - name: Version @@ -6996,7 +6996,7 @@ paths: tags: - credentialsKeyedByType summary: 'List credentials by type' - description: 'Get a list of all the known credentials, keyed by the type.' + description: 'Returns a dictionary of all credentials stored on the hub, organized by credential type, using a POST body. Each key in the response is a credential type, and the value is the list of credential keys of that type.' operationId: GetCredentialsKeyedByType_Post requestBody: content: @@ -7026,7 +7026,7 @@ paths: tags: - credentials summary: List credentials of specified type - description: Gets a list of all credentials of the specified type. + description: Returns a list of all credentials of the specified CredentialType stored on the hub. Optionally filter by associated agent or group using the DeviceFilter parameter. operationId: GetCredentialsList_Get parameters: - name: CredentialType @@ -7072,7 +7072,7 @@ paths: tags: - credentials summary: List credentials of specified type - description: Gets a list of all credentials of the specified type. + description: Returns a list of all credentials of the specified CredentialType stored on the hub, using a POST body. Optionally filter by associated agent or group using the DeviceFilter parameter. operationId: GetCredentialsList_Post requestBody: content: @@ -7099,7 +7099,7 @@ paths: tags: - command summary: 'Get task status' - description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + description: 'Returns status information for the specified agent tasks. Provide a list of task IDs to query individual tasks, or supply a PolicyRunId to retrieve all tasks associated with a specific policy run.' operationId: GetAgentTaskStatusestasksstatus_Get parameters: - name: Ids @@ -7138,7 +7138,7 @@ paths: tags: - command summary: 'Get task status' - description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + description: 'Returns status information for the specified agent tasks using a POST body. Provide a list of task IDs to query individual tasks, or supply a PolicyRunId to retrieve all tasks associated with a specific policy run.' operationId: GetAgentTaskStatusestasksstatus_Post requestBody: content: @@ -7162,7 +7162,7 @@ paths: tags: - command summary: 'Get task status' - description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + description: 'Returns status information for the agent tasks whose IDs are provided in the path. If a PolicyRunId is supplied as a query parameter, all tasks associated with that policy run are also returned.' operationId: GetAgentTaskStatusestasksstatusidsIds_Get parameters: - name: Ids @@ -7201,7 +7201,7 @@ paths: tags: - command summary: 'Get task status' - description: 'Requests information about the given tasks'' status. If a PolicyRunId is supplied, the tasks associated with it are returned.' + description: 'Returns status information for the agent tasks whose IDs are provided using a POST body. If a PolicyRunId is supplied, all tasks associated with that policy run are also returned.' operationId: GetAgentTaskStatusestasksstatusidsIds_Post requestBody: content: @@ -7225,7 +7225,7 @@ paths: tags: - command summary: Add agent tasks - description: Adds a list of tasks for the given agent. + description: Submits a list of tasks to the queue for the specified agent. The AgentId path parameter identifies the target agent. Returns the assigned task IDs in the response, which you can use to monitor task status. operationId: SubmitAgentTaskstasksaddagentAgentId_Get parameters: - name: Tasks @@ -7256,7 +7256,7 @@ paths: tags: - command summary: Add agent tasks - description: Adds a list of tasks for the given agent. + description: Submits a list of tasks to the queue for the specified agent using a POST body. The AgentId path parameter identifies the target agent. Returns the assigned task IDs in the response. operationId: SubmitAgentTaskstasksaddagentAgentId_Post requestBody: content: @@ -7280,7 +7280,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns tasks for the specified agent, identified by its legacy ID. Filter results by task status, task type, policy run ID, or a list of specific task IDs. By default, only tasks currently within their active date range are returned; set IgnoreActiveDates to override this behavior. operationId: GetAgentTaskstasksagentlegacyLegacyId_Get parameters: - name: AgentId @@ -7395,7 +7395,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns tasks for the specified agent identified by its legacy ID, using a POST body. Filter results by task status, task type, policy run ID, or specific task IDs. Set IgnoreActiveDates to retrieve tasks outside their active date range. operationId: GetAgentTaskstasksagentlegacyLegacyId_Post requestBody: content: @@ -7419,7 +7419,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns tasks for the specified agent, with the AllTasks path parameter controlling whether all tasks or only active tasks are included. Filter results by task status, task type, policy run ID, or a list of specific task IDs. operationId: GetAgentTaskstasksagentAgentIdallAllTasks_Get parameters: - name: AgentId @@ -7534,7 +7534,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns tasks for the specified agent using a POST body, with the AllTasks path parameter controlling whether all tasks or only active tasks are included. Filter results by task status, task type, or policy run ID. operationId: GetAgentTaskstasksagentAgentIdallAllTasks_Post requestBody: content: @@ -7558,7 +7558,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns task information for the specified agent, identified by AgentId. Use the TaskStatuses, TaskType, and TaskIds parameters to filter results, and set Concise to true to omit large text and result-data fields from the response. operationId: GetAgentTaskstasksagentAgentIdsingleTaskId_Get parameters: - name: AgentId @@ -7673,7 +7673,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Submits a request for task information for the specified agent. Accepts the same filtering options as the GET variant, including TaskStatuses, TaskType, and Concise mode, via the request body. operationId: GetAgentTaskstasksagentAgentIdsingleTaskId_Post requestBody: content: @@ -7697,7 +7697,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns task information for a legacy agent identified by its LegacyId, optionally retrieving all tasks. Supports the same status, type, and pagination filtering as the standard agent task endpoints. operationId: GetAgentTaskstasksagentlegacyLegacyIdallAllTasks_Get parameters: - name: AgentId @@ -7812,7 +7812,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Submits a request for task information for a legacy agent identified by its LegacyId. Supply filtering and pagination options in the request body. operationId: GetAgentTaskstasksagentlegacyLegacyIdallAllTasks_Post requestBody: content: @@ -7836,7 +7836,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Returns task information for a single task associated with a legacy agent, identified by LegacyId and TaskId. Use TaskStatuses and TaskType to narrow the results. operationId: GetAgentTaskstasksagentlegacyLegacyIdsingleTaskId_Get parameters: - name: AgentId @@ -7951,7 +7951,7 @@ paths: tags: - command summary: Get tasks for given agent - description: Requests information about tasks for the given agent. + description: Submits a request for a single task record associated with a legacy agent. Provide the LegacyId, TaskId, and any filtering options in the request body. operationId: GetAgentTaskstasksagentlegacyLegacyIdsingleTaskId_Post requestBody: content: @@ -7975,7 +7975,7 @@ paths: tags: - downloadFileHash summary: Download file hashing utility - description: Download the filehasing utility app for remote monitoring. + description: Downloads the file-hashing utility binary for remote monitoring, targeting the specified host type, operating system, and architecture variant. Set ReturnUrl to true to receive a download URL instead of the file directly. operationId: DownloadFileHashBinaryHostTypeOperatingSystemVariant_Get parameters: - name: ReturnUrl @@ -8034,7 +8034,7 @@ paths: tags: - downloadFileHash summary: Download file hashing utility - description: Download the filehasing utility app for remote monitoring. + description: Submits a request to download the file-hashing utility binary for remote monitoring. Supply the host type, operating system, variant, and ReturnUrl preference in the request body. operationId: DownloadFileHashBinaryHostTypeOperatingSystemVariant_Post requestBody: content: @@ -8058,7 +8058,7 @@ paths: tags: - downloadFileHashById summary: Download file hashing utility - description: Download the filehasing utility app for remote monitoring. + description: Downloads the file-hashing utility binary identified by its unique FileId. Set ReturnUrl to true to receive a redirect URL instead of streaming the file directly in the response. operationId: DownloadFileHashBinaryFileId_Get parameters: - name: ReturnUrl @@ -8117,7 +8117,7 @@ paths: tags: - downloadFileHashById summary: Download file hashing utility - description: Download the filehasing utility app for remote monitoring. + description: Submits a request to download a specific file-hashing utility binary by its FileId. Supply the FileId and ReturnUrl preference in the request body. operationId: DownloadFileHashBinaryFileId_Post requestBody: content: @@ -8141,7 +8141,7 @@ paths: tags: - getFileHashBinaries summary: List file hash binaries - description: Retrieves the list of file hash binaries available to download from the hub. + description: Returns the complete list of file-hashing utility binaries available for download from the hub. Use this endpoint to discover which binaries are available before calling the download endpoints. operationId: GetFileHashBinaries_Get parameters: - name: Version @@ -8167,7 +8167,7 @@ paths: tags: - getFileHashBinaries summary: List file hash binaries - description: Retrieves the list of file hash binaries available to download from the hub. + description: Submits a request to retrieve the list of file-hashing utility binaries available for download from the hub. Returns the same data as the GET variant. operationId: GetFileHashBinaries_Post requestBody: content: @@ -8194,7 +8194,7 @@ paths: tags: - plannedChangeInstances summary: Get planned change instance members - description: Gets the group and device members of the specified planned change instance. + description: Returns the group and device members of the specified planned change instance, identified by InstanceId. Use this endpoint to inspect which devices and groups are in scope for a given planned change. operationId: GetPlannedChangeInstanceMembersmembers_Get parameters: - name: InstanceId @@ -8223,7 +8223,7 @@ paths: tags: - plannedChangeInstances summary: Get planned change instance members - description: Gets the group and device members of the specified planned change instance. + description: Submits a request to retrieve the group and device members of the specified planned change instance. Provide the InstanceId in the request body. operationId: GetPlannedChangeInstanceMembersmembers_Post requestBody: content: @@ -8247,7 +8247,7 @@ paths: tags: - plannedChangeInstances summary: Delete a planned change instance - description: Deletes an instance of a planned change from the system. + description: Deletes the specified planned change instance, identified by InstanceId. Optionally pass DeletePlannedChange as true to also remove the parent planned change definition from the system. operationId: DeletePlannedChangeInstancedelete_Get parameters: - name: InstanceId @@ -8280,7 +8280,7 @@ paths: tags: - plannedChangeInstances summary: Delete a planned change instance - description: Deletes an instance of a planned change from the system. + description: Submits a request to delete a planned change instance. Supply the InstanceId and optionally set DeletePlannedChange to true in the request body to also remove the parent planned change definition. operationId: DeletePlannedChangeInstancedelete_Post requestBody: content: @@ -8302,7 +8302,7 @@ paths: tags: - plannedChangeInstances summary: Remove member from planned change - description: Removes a group or device from a planned change + description: Removes a specific group or device member from the specified planned change instance, identified by InstanceId. Provide either a GroupName or an AgentDeviceId to identify the member to remove. operationId: DeletePlannedChangeInstanceMemberdeleteMember_Get parameters: - name: GroupName @@ -8339,7 +8339,7 @@ paths: tags: - plannedChangeInstances summary: Remove member from planned change - description: Removes a group or device from a planned change + description: Submits a request to remove a group or device member from a planned change instance. Provide the InstanceId and either a GroupName or AgentDeviceId in the request body. operationId: DeletePlannedChangeInstanceMemberdeleteMember_Post requestBody: content: @@ -8361,7 +8361,7 @@ paths: tags: - plannedChangeInstances summary: Add a planned change instance. - description: Add a planned change instance. + description: Creates a new planned change instance, optionally associating it with an existing planned change definition by name. Specify member groups or individual devices, set start and end times, and configure periodicity for recurring windows. Returns the created instance details. operationId: AddPlannedChangeInstanceadd_Get parameters: - name: PlannedChangeName @@ -8495,7 +8495,7 @@ paths: tags: - plannedChangeInstances summary: Add a planned change instance. - description: Add a planned change instance. + description: Submits a request to create a new planned change instance. Provide the display name, description, member groups, device IDs, and scheduling options in the request body. operationId: AddPlannedChangeInstanceadd_Post requestBody: content: @@ -8519,7 +8519,7 @@ paths: tags: - plannedChangeInstances summary: Update a planned change instance - description: Update a planned change instance + description: Updates properties of an existing planned change instance, identified by InstanceId. You can modify the description, assigned ruleset, member groups, devices, scheduling, and enabled state. Returns the updated instance details. operationId: UpdatePlannedChangeInstanceupdate_Get parameters: - name: InstanceId @@ -8638,7 +8638,7 @@ paths: tags: - plannedChangeInstances summary: Update a planned change instance - description: Update a planned change instance + description: Submits a request to update an existing planned change instance. Provide the InstanceId and any fields to change in the request body. Returns the updated instance details. operationId: UpdatePlannedChangeInstanceupdate_Post requestBody: content: @@ -8662,7 +8662,7 @@ paths: tags: - plannedChangeInstances summary: Clone a planned change instance. - description: Clone a planned change instance. + description: Creates a copy of an existing planned change instance, identified by InstanceId. Set CloneDefinition to true to also duplicate the associated planned change ruleset definition. Returns the new cloned instance. operationId: ClonePlannedChangeInstanceclone_Get parameters: - name: InstanceId @@ -8697,7 +8697,7 @@ paths: tags: - plannedChangeInstances summary: Clone a planned change instance. - description: Clone a planned change instance. + description: Submits a request to clone an existing planned change instance. Provide the InstanceId and CloneDefinition flag in the request body. Returns the new cloned instance. operationId: ClonePlannedChangeInstanceclone_Post requestBody: content: @@ -8721,7 +8721,7 @@ paths: tags: - plannedChangeInstances summary: 'Get planned change instance names' - description: 'Gets planned change instances name and id, filtering by name, id or groups that are members.' + description: 'Returns a lightweight list of planned change instance names and IDs, filtered by name, ID, member groups, or schedule status. Use this endpoint to populate selection lists without fetching full instance details.' operationId: GetPlannedChangeInstancesNameValuenameValue_Get parameters: - name: InstanceIds @@ -8857,7 +8857,7 @@ paths: tags: - plannedChangeInstances summary: 'Get planned change instance names' - description: 'Gets planned change instances name and id, filtering by name, id or groups that are members.' + description: 'Submits a request to retrieve planned change instance names and IDs. Provide filter criteria such as member groups, display name, and schedule status in the request body.' operationId: GetPlannedChangeInstancesNameValuenameValue_Post requestBody: content: @@ -8881,7 +8881,7 @@ paths: tags: - plannedChangeInstances summary: Add groups to a planned change - description: Add a list of groups to a planned change + description: Adds one or more groups or individual devices as members to the specified planned change instance, identified by InstanceId. Supply MemberGroups names and/or MemberAgentDeviceIds to assign scope. operationId: AddPlannedChangeInstanceMemberaddMembers_Get parameters: - name: MemberGroups @@ -8924,7 +8924,7 @@ paths: tags: - plannedChangeInstances summary: Add groups to a planned change - description: Add a list of groups to a planned change + description: Submits a request to add groups or devices as members to a planned change instance. Provide the InstanceId, MemberGroups, and MemberAgentDeviceIds in the request body. operationId: AddPlannedChangeInstanceMemberaddMembers_Post requestBody: content: @@ -8946,7 +8946,7 @@ paths: tags: - plannedChangeInstances summary: Add planned change from events - description: A request to add a new planned change and planned change instance based on the given events. + description: Creates or updates a planned change and its associated instance using the specified events as the basis for generating filter rules. Set PreviewOnly to true to inspect the resulting configuration without persisting it. Returns the planned change instance details, including any inferred rules. operationId: AddOrUpdatePlannedChangeInstanceFromEventsaddOrUpdateFromEvents_Get parameters: - name: AllEventsSelected @@ -9050,7 +9050,7 @@ paths: tags: - plannedChangeInstances summary: Add planned change from events - description: A request to add a new planned change and planned change instance based on the given events. + description: Submits a request to create or update a planned change instance derived from the specified events. Provide event selection criteria, rule builder options, and instance configuration in the request body. operationId: AddOrUpdatePlannedChangeInstanceFromEventsaddOrUpdateFromEvents_Post requestBody: content: @@ -9074,7 +9074,7 @@ paths: tags: - plannedChangeInstances summary: Re-evaluate planned change instance events - description: A request to re-evaluate the events associated with the specified planned change. + description: Triggers re-evaluation of events associated with the specified planned change instance, retrospectively applying the instance's rules to events within the specified UTC time range. Use this endpoint after modifying rules to reclassify historical events. operationId: AddReEvaluationOfPlannedChangeInstanceEventsreevaluateEvents_Get parameters: - name: InstanceId @@ -9118,7 +9118,7 @@ paths: tags: - plannedChangeInstances summary: Re-evaluate planned change instance events - description: A request to re-evaluate the events associated with the specified planned change. + description: Submits a request to re-evaluate planned change events within a specified time range. Provide the InstanceId and the earliest and latest event timestamps in the request body. operationId: AddReEvaluationOfPlannedChangeInstanceEventsreevaluateEvents_Post requestBody: content: @@ -9140,7 +9140,7 @@ paths: tags: - plannedChangeInstances summary: 'Get planned change instances' - description: 'Gets planned change instances, filtering by name, id or groups that are members.' + description: 'Returns a list of planned change instances, optionally filtered by name, ID, member groups, schedule status, and date range. Use OmitPlannedChangeDefinitions to return a lighter payload when full ruleset details are not needed.' operationId: GetPlannedChangeInstances_Get parameters: - name: InstanceIds @@ -9282,7 +9282,7 @@ paths: tags: - plannedChangeInstances summary: 'Get planned change instances' - description: 'Gets planned change instances, filtering by name, id or groups that are members.' + description: 'Submits a request to retrieve planned change instances. Provide filter criteria such as member groups, display name, and date range in the request body.' operationId: GetPlannedChangeInstances_Post requestBody: content: @@ -9306,7 +9306,7 @@ paths: tags: - plannedChanges summary: Add a planned change definition. - description: Add a planned change definition. + description: Creates a new planned change ruleset definition with the specified name, display name, and filter rules. Optionally set DisallowRules to create a container for manually added events without automatic rule matching. Returns the created definition. operationId: AddPlannedChangeadd_Get parameters: - name: Version @@ -9388,7 +9388,7 @@ paths: tags: - plannedChanges summary: Add a planned change definition. - description: Add a planned change definition. + description: Submits a request to create a new planned change ruleset definition. Provide the name, display name, rules, and rule combination operator in the request body. operationId: AddPlannedChangeadd_Post requestBody: content: @@ -9412,7 +9412,7 @@ paths: tags: - plannedChanges summary: Upload a planned change ruleset json file - description: Upload a planned change ruleset json file + description: Uploads a planned change ruleset as a JSON file, creating or replacing the corresponding definition on the hub. Use this endpoint to import exported planned change configurations. operationId: UploadPlannedChangeupload_Post requestBody: content: @@ -9434,7 +9434,7 @@ paths: tags: - plannedChanges summary: Download a planned change ruleset json file - description: Download a planned change ruleset json file + description: Downloads the specified planned change ruleset as a JSON file. Use the IncludeAttributeRuleList and IncludeAttributeRuleText parameters to control whether list-based attribute rule data is included in the export. operationId: DownloadPlannedChangedownload_Get parameters: - name: Id @@ -9474,7 +9474,7 @@ paths: tags: - plannedChanges summary: Download a planned change ruleset json file - description: Download a planned change ruleset json file + description: Submits a request to download a planned change ruleset as a JSON file. Provide the ruleset ID and export options in the request body. operationId: DownloadPlannedChangedownload_Post requestBody: content: @@ -9498,7 +9498,7 @@ paths: tags: - plannedChanges summary: Update a planned change definition - description: Update a planned change definition + description: Updates the specified planned change ruleset definition, including its display name, description, rules, and rule combination operator. The internal Name cannot be changed. Returns the updated definition. operationId: UpdatePlannedChangeupdate_Get parameters: - name: Name @@ -9560,7 +9560,7 @@ paths: tags: - plannedChanges summary: Update a planned change definition - description: Update a planned change definition + description: Submits a request to update a planned change ruleset definition. Provide the Name identifying the ruleset and any fields to change in the request body. operationId: UpdatePlannedChangeupdate_Post requestBody: content: @@ -9584,7 +9584,7 @@ paths: tags: - plannedChanges summary: Clone a planned change definition. - description: Clone a planned change definition. + description: Creates a copy of the specified planned change ruleset definition, identified by its internal Name. Returns the new cloned definition with a system-generated name. operationId: ClonePlannedChangeclone_Get parameters: - name: Name @@ -9612,7 +9612,7 @@ paths: tags: - plannedChanges summary: Clone a planned change definition. - description: Clone a planned change definition. + description: Submits a request to clone a planned change ruleset definition. Provide the Name of the definition to copy in the request body. operationId: ClonePlannedChangeclone_Post requestBody: content: @@ -9636,7 +9636,7 @@ paths: tags: - plannedChanges summary: 'Create planned change rule reduction' - description: 'Create rule reduction plans, which can be used to simplify rulesets associated with the specified planned change.' + description: 'Analyzes the specified planned change ruleset and generates rule reduction plans that can simplify the associated rules. For example, two exact filename matches within the same directory may be combined into a single wildcard rule. Returns reduction plan suggestions without applying them.' operationId: AnalyzePlannedChangeanalyze_Get parameters: - name: Name @@ -9672,7 +9672,7 @@ paths: tags: - plannedChanges summary: 'Create planned change rule reduction' - description: 'Create rule reduction plans, which can be used to simplify rulesets associated with the specified planned change.' + description: 'Submits an analysis request to generate rule reduction plans for the specified planned change. Provide the planned change Name and the rule IDs to evaluate in the request body.' operationId: AnalyzePlannedChangeanalyze_Post requestBody: content: @@ -9696,7 +9696,7 @@ paths: tags: - plannedChanges summary: 'Apply planned change rule reduction' - description: 'Apply rule reduction plans to the specified planned change, simplifying the associated rulesets.' + description: 'Applies a previously generated rule reduction plan to the specified planned change, removing redundant rules and replacing them with the simplified alternatives. Returns no content on success.' operationId: ApplyPlannedChangePlanapplyPlan_Get parameters: - name: Name @@ -9735,7 +9735,7 @@ paths: tags: - plannedChanges summary: 'Apply planned change rule reduction' - description: 'Apply rule reduction plans to the specified planned change, simplifying the associated rulesets.' + description: 'Submits a request to apply a rule reduction plan to the specified planned change. Provide the planned change Name, rule IDs to remove, and the reduction plan details in the request body.' operationId: ApplyPlannedChangePlanapplyPlan_Post requestBody: content: @@ -9757,7 +9757,7 @@ paths: tags: - plannedChanges summary: Update planned change rule - description: Updates a rule in a planned change + description: Updates a single filter rule within an existing planned change definition. Use this endpoint to modify individual rule attributes without replacing the entire ruleset. operationId: UpdatePlannedChangeRuleupdateRule_Get parameters: - name: Version @@ -9778,7 +9778,7 @@ paths: tags: - plannedChanges summary: Update planned change rule - description: Updates a rule in a planned change + description: Submits a request to update a single filter rule in an existing planned change definition. Provide the rule update details in the request body. operationId: UpdatePlannedChangeRuleupdateRule_Post requestBody: content: @@ -9800,7 +9800,7 @@ paths: tags: - plannedChanges summary: Update planned change rule set - description: Updates the entire rule set in a planned change + description: Replaces the entire rule set in the specified planned change definition with the provided rules. This endpoint is deprecated; use the individual rule update endpoints for new integrations. operationId: UpdatePlannedChangeRulesupdateRules_Get parameters: - name: PlannedChangeName @@ -9838,7 +9838,7 @@ paths: tags: - plannedChanges summary: Update planned change rule set - description: Updates the entire rule set in a planned change + description: Submits a request to replace the entire rule set in the specified planned change definition. This endpoint is deprecated; use the individual rule update endpoints for new integrations. operationId: UpdatePlannedChangeRulesupdateRules_Post requestBody: content: @@ -9863,7 +9863,7 @@ paths: tags: - plannedChanges summary: Remove rule from planned change. - description: Removes a rule from a planned change + description: Removes a specific filter rule, identified by its ID, from the specified planned change definition. Returns no content on success. operationId: DeletePlannedChangeRuledeleteRule_Get parameters: - name: PlannedChangeName @@ -9894,7 +9894,7 @@ paths: tags: - plannedChanges summary: Remove rule from planned change. - description: Removes a rule from a planned change + description: Submits a request to remove a filter rule from a planned change definition. Provide the planned change name and the rule ID in the request body. operationId: DeletePlannedChangeRuledeleteRule_Post requestBody: content: @@ -9916,7 +9916,7 @@ paths: tags: - plannedChanges summary: Delete a planned change ruleset - description: Delete a planned change ruleset definition from the system. + description: Permanently deletes the specified planned change ruleset definition from the system, identified by Name. This action cannot be undone; consider cloning the definition before deleting if you may need it later. operationId: DeletePlannedChangedelete_Get parameters: - name: Name @@ -9942,7 +9942,7 @@ paths: tags: - plannedChanges summary: Delete a planned change ruleset - description: Delete a planned change ruleset definition from the system. + description: Submits a request to permanently delete a planned change ruleset definition. Provide the Name of the definition to remove in the request body. operationId: DeletePlannedChangedelete_Post requestBody: content: @@ -9964,7 +9964,7 @@ paths: tags: - plannedChangeRule summary: Add rule to a planned change. - description: Add a rule to a planned change + description: Adds a new filter rule to the specified planned change definition, identified by PlannedChangeName. Returns the ID of the newly created rule. operationId: AddPlannedChangeRuleadd_Get parameters: - name: PlannedChangeName @@ -9997,7 +9997,7 @@ paths: tags: - plannedChangeRule summary: Add rule to a planned change. - description: Add a rule to a planned change + description: Submits a request to add a filter rule to a planned change definition. Provide the planned change name and the new rule object in the request body. Returns the ID of the newly created rule. operationId: AddPlannedChangeRuleadd_Post requestBody: content: @@ -10021,7 +10021,7 @@ paths: tags: - plannedChanges summary: 'Get planned change ruleset definitions' - description: 'Gets a list of planned change ruleset definitions, filtered by name or id.' + description: 'Returns a paged list of planned change ruleset definitions, optionally filtered by name or display name. Use the DisallowRules filter to find definitions that act as manual event containers only.' operationId: GetPlannedChanges_Get parameters: - name: Name @@ -10104,7 +10104,7 @@ paths: tags: - plannedChanges summary: 'Get planned change ruleset definitions' - description: 'Gets a list of planned change ruleset definitions, filtered by name or id.' + description: 'Submits a request to retrieve planned change ruleset definitions. Provide name filters and pagination options in the request body.' operationId: GetPlannedChanges_Post requestBody: content: @@ -10128,7 +10128,7 @@ paths: tags: - commandParser summary: 'Parse command line' - description: 'Attempts to parse the supplied commandline, returning a list of disallowed command fragments on failure.' + description: 'Validates one or more command-line strings against the allowed command component list. Returns a list of disallowed fragments if validation fails, or an empty result if the commands are permitted.' operationId: ParseCommandsparse_Get parameters: - name: CommandLines @@ -10159,7 +10159,7 @@ paths: tags: - commandParser summary: 'Parse command line' - description: 'Attempts to parse the supplied commandline, returning a list of disallowed command fragments on failure.' + description: 'Submits one or more command-line strings for validation against the allowed command component list. Provide the CommandLines in the request body. Returns any disallowed fragments found.' operationId: ParseCommandsparse_Post requestBody: content: @@ -10183,7 +10183,7 @@ paths: tags: - commandParser summary: Gets the whitelisted command component. - description: Gets the whitelisted command component. + description: Returns the current set of whitelisted command components that are permitted when validating command-line strings. Use this endpoint to review the allowed list before adding or updating entries. operationId: GetWhitelistedCommandComponentwhitelist_Get parameters: - name: Version @@ -10206,7 +10206,7 @@ paths: tags: - commandParser summary: Whitelists a command component. - description: Attempts to whitelist the supplied command component. + description: Adds a new command component to the allowlist so that it passes command-line validation. Provide the component details in the request body. Returns the updated allowlist. operationId: CreateWhitelistedCommandComponentwhitelist_Post requestBody: content: @@ -10230,7 +10230,7 @@ paths: tags: - commandParser summary: List whitelisted command components - description: Attempts to get all the whitelisted command components. + description: Returns a paged list of all whitelisted command components. Use the Sort, Skip, Take, and GenericFilters parameters to control pagination and ordering of results. operationId: GetAllWhitelistedCommandComponentswhitelistall_Get parameters: - name: CountOnly @@ -10296,7 +10296,7 @@ paths: tags: - commandParser summary: Update command component by ID - description: Attempts to update the supplied command component by id. + description: Updates an existing whitelisted command component, identified by its ID. Provide the updated component details in the request body. Returns the updated allowlist. operationId: UpdateWhitelistedCommandComponentwhitelistupdate_Post requestBody: content: @@ -10320,7 +10320,7 @@ paths: tags: - commandParser summary: Bulk update command components - description: Attempts to bulk update the whitelisted command component with the supplied ids. + description: Performs a bulk update on multiple whitelisted command components identified by their IDs. Provide the list of IDs and the updated properties in the request body. Returns the updated allowlist. operationId: UpdateWhitelistedCommandComponentswhitelistupdateMany_Post requestBody: content: @@ -10344,7 +10344,7 @@ paths: tags: - commandParser summary: Add templates to command component - description: Adds the given template(s) to a command component. + description: Associates one or more policy templates with the specified command component. Use this endpoint to extend the set of templates that govern command-line validation for a given component. operationId: AddTemplatesToCommandComponentcommandComponentaddTemplates_Post requestBody: content: @@ -10368,7 +10368,7 @@ paths: tags: - commandParser summary: Remove templates from command component - description: Attempts to remove the given template(s) from a command component. + description: Removes one or more policy template associations from the specified command component. Templates that are not currently associated are silently ignored. operationId: RemoveTemplatesFromCommandComponentcommandComponentremoveTemplates_Post requestBody: content: @@ -10392,7 +10392,7 @@ paths: tags: - commandParser summary: Get templates for command component - description: Gets all templates of a command component. + description: Returns a paged list of all policy templates associated with the specified command component. Use the Sort, Skip, and Take parameters to control pagination. operationId: GetAllCommandComponentTemplatescommandComponenttemplates_Get parameters: - name: CountOnly @@ -10455,7 +10455,7 @@ paths: tags: - commandParser summary: 'Set command component templates' - description: 'Attempts to set the given template(s) to a command component, clearing old templates if they exist.' + description: 'Replaces all policy template associations for the specified command component with the provided list, removing any previously associated templates. Provide the component ID and the new template list in the request body.' operationId: SetAllTemplatesOfCommandComponentcommandComponenttemplates_Post requestBody: content: @@ -10479,7 +10479,7 @@ paths: tags: - commandParser summary: Get templates for command components - description: Gets all templates of multiple command components. + description: Returns the policy templates associated with multiple command components in a single request. Provide the component IDs in the request body. operationId: GetAllCommandComponentsTemplatescommandComponentManytemplates_Post requestBody: content: @@ -10503,7 +10503,7 @@ paths: tags: - cloudTemplate summary: Get cloud template creation status - description: Provide a ProspectiveName for the Cloud System or a ReportSpecId to identify the associated cloud report but never both. Gets the state of progress in the creation of a new cloud report policy. For example it may be only partially configured and require the addition of credentials before it can be run. + description: Returns the creation progress status for a new cloud report policy. Provide either a ProspectiveName for the cloud system or a ReportSpecId to identify an existing cloud report, but not both. The response indicates whether the policy is fully configured or requires additional steps such as adding credentials. operationId: GetCloudTemplateCreationStatusstatus_Get parameters: - name: ProspectiveName @@ -10542,7 +10542,7 @@ paths: tags: - cloudTemplate summary: Get cloud template creation status - description: Provide a ProspectiveName for the Cloud System or a ReportSpecId to identify the associated cloud report but never both. Gets the state of progress in the creation of a new cloud report policy. For example it may be only partially configured and require the addition of credentials before it can be run. + description: Submits a request to retrieve the creation progress status for a new cloud report policy. Provide either ProspectiveName or ReportSpecId in the request body, but not both. operationId: GetCloudTemplateCreationStatusstatus_Post requestBody: content: @@ -10566,7 +10566,7 @@ paths: tags: - policyTemplate summary: Set up baseline policy template - description: Ensures that the specified baseline template has the required source and members groups and related scheduled compliance report configured. + description: Sets up the specified baseline policy template by ensuring that the required source and member groups and associated scheduled compliance report are correctly configured. Use this endpoint to initialise a template before running compliance scans against it. operationId: SetupPolicyTemplatesetup_Get parameters: - name: PolicyTemplateName @@ -10594,7 +10594,7 @@ paths: tags: - policyTemplate summary: Set up baseline policy template - description: Ensures that the specified baseline template has the required source and members groups and related scheduled compliance report configured. + description: Submits a setup request for the specified baseline policy template. Provide the PolicyTemplateName in the request body to initialise the required groups and scheduled compliance report. operationId: SetupPolicyTemplatesetup_Post requestBody: content: @@ -10618,7 +10618,7 @@ paths: tags: - policyTemplate summary: Get policy creation status - description: Gets the state of progress in the creation of a new policy. For example it may be only partially configured and require the addition of rules before it can be applied to devices. + description: Returns the creation progress status for the specified policy template. The response indicates whether the policy is fully configured or requires additional steps, such as adding rules, before it can be applied to devices. operationId: GetPolicyTemplateCreationStatusstatus_Get parameters: - name: PolicyTemplateName @@ -10646,7 +10646,7 @@ paths: tags: - policyTemplate summary: Get policy creation status - description: Gets the state of progress in the creation of a new policy. For example it may be only partially configured and require the addition of rules before it can be applied to devices. + description: Submits a request to retrieve the creation progress status for the specified policy template. Provide the PolicyTemplateName in the request body. operationId: GetPolicyTemplateCreationStatusstatus_Post requestBody: content: @@ -10670,7 +10670,7 @@ paths: tags: - policyTemplate summary: Adds a device config template. - description: Adds a device config template. + description: Creates a new device configuration template using the provided PolicyTemplateRuleSet definition. Optionally specify UsageTags to categorize the template (for example, Baseline or Tracking) and a ChangeComment for audit purposes. operationId: AddPolicyTemplateadd_Get parameters: - name: Template @@ -10711,7 +10711,7 @@ paths: tags: - policyTemplate summary: Adds a device config template. - description: Adds a device config template. + description: Submits a request to create a new device configuration template. Provide the template definition, usage tags, and change comment in the request body. operationId: AddPolicyTemplateadd_Post requestBody: content: @@ -10735,7 +10735,7 @@ paths: tags: - policyRecent summary: Get most recent policy results - description: Gets the most recent policy run results for each matching policy in the time range. + description: Returns the most recent policy run results for each matching policy within the specified time range, filterable by usage tag and group. Use ExcludePoliciesWithNoDevices, ExcludePoliciesNotSetup, and ExcludePoliciesWithNoResults to refine the result set. operationId: GetMostRecentPolicyResults_Get parameters: - name: UsageTag @@ -10840,7 +10840,7 @@ paths: tags: - policyRecent summary: Get most recent policy results - description: Gets the most recent policy run results for each matching policy in the time range. + description: Submits a request to retrieve the most recent policy run results. Provide usage tag, group name, and exclusion flags in the request body. operationId: GetMostRecentPolicyResults_Post requestBody: content: @@ -10864,7 +10864,7 @@ paths: tags: - policyTemplate summary: Add rules to baseline policy - description: Add a rules to a baseline policy based on events + description: Adds one or more rules to a baseline policy template, derived from recent events. Set PreviewChanges to true to inspect the proposed rule additions without saving them. Returns the new rules and any affected report sections. operationId: AddPolicyTemplateRulesaddrules_Get parameters: - name: Name @@ -10923,7 +10923,7 @@ paths: tags: - policyTemplate summary: Add rules to baseline policy - description: Add a rules to a baseline policy based on events + description: Submits a request to add rules to a baseline policy template based on events. Provide the template name, event time range, and rule builder options in the request body. operationId: AddPolicyTemplateRulesaddrules_Post requestBody: content: @@ -10947,7 +10947,7 @@ paths: tags: - devicePolicyTemplate summary: Add device policy template - description: Adds a device policy template to the system. The specified template should be supplied as Xml. + description: Adds a device policy template to the system using an XML definition. You can optionally copy an existing template's tracking configuration by specifying AsCopyOf. Set OverwriteIfExists to true to replace an existing template with the same name. operationId: AddPolicyTemplateXmladd_Get parameters: - name: Name @@ -11035,7 +11035,7 @@ paths: tags: - devicePolicyTemplate summary: Add device policy template - description: Adds a device policy template to the system. The specified template should be supplied as Xml. + description: Submits a request to add a device policy template using an XML definition. Provide the template XML, name, and optional copy-from and overwrite settings in the request body. operationId: AddPolicyTemplateXmladd_Post requestBody: content: @@ -11059,7 +11059,7 @@ paths: tags: - devicePolicyTemplate summary: Delete device policy template - description: Deletes a device policy template from the system. The specified template can be either config or a compliance report template. + description: Deletes the specified device policy template from the system. The template can be either a configuration tracking template or a compliance report template. If TemplateVersion is not supplied, all versions of the template are removed. operationId: DeletePolicyTemplatedelete_Get parameters: - name: Name @@ -11090,7 +11090,7 @@ paths: tags: - devicePolicyTemplate summary: Delete device policy template - description: Deletes a device policy template from the system. The specified template can be either config or a compliance report template. + description: Submits a request to delete a device policy template. Provide the template Name and optionally a specific TemplateVersion to delete in the request body. If no version is supplied, all versions are removed. operationId: DeletePolicyTemplatedelete_Post requestBody: content: @@ -11112,7 +11112,7 @@ paths: tags: - uploadPolicyTemplate summary: Upload a policy template file - description: Upload a policy template file + description: Uploads a policy template file to the hub. Use this endpoint to import policy templates in bulk or to replace existing definitions from an exported file. operationId: UploadPolicyTemplate_Post requestBody: content: @@ -11136,7 +11136,7 @@ paths: tags: - policyTemplateAsFile summary: Download policy template as XML - description: Returns a policy template as an xml file in the Http Response stream. + description: Downloads the specified policy template as an XML file delivered in the HTTP response stream. Specify the template Name to retrieve a named template, or provide an AgentDeviceId to download the combined template currently applied to that device. operationId: GetPolicyTemplateAsFile_Get parameters: - name: Name @@ -11169,7 +11169,7 @@ paths: tags: - policyTemplateAsFile summary: Download policy template as XML - description: Returns a policy template as an xml file in the Http Response stream. + description: Submits a request to download a policy template as an XML file. Provide the template Name or AgentDeviceId in the request body. operationId: GetPolicyTemplateAsFile_Post requestBody: content: @@ -11193,7 +11193,7 @@ paths: tags: - agentProcesses summary: Get agent running processes - description: Get the list of running processes from a specified agent / device.Used to enable 'white-listing' if existing processes from a running agent when building device config. + description: Returns the list of currently running processes on the specified agent or device. Use this data to build process allowlists when configuring device tracking templates. operationId: GetAgentProcesses_Get parameters: - name: AgentDevice @@ -11221,7 +11221,7 @@ paths: tags: - agentProcesses summary: Get agent running processes - description: Get the list of running processes from a specified agent / device.Used to enable 'white-listing' if existing processes from a running agent when building device config. + description: Submits a request to retrieve the list of currently running processes from the specified agent or device. Provide the AgentDevice details in the request body. operationId: GetAgentProcesses_Post requestBody: content: @@ -11245,7 +11245,7 @@ paths: tags: - startAgentTracker summary: Start a tracker on an agent - description: Ask an agent to start a specified tracker. + description: Instructs the specified agent to start the named tracker. Use the AgentDevice or AgentDeviceId parameter to identify the target agent, and TrackerName to specify which tracker to start. operationId: StartAgentTracker_Get parameters: - name: AgentDevice @@ -11283,7 +11283,7 @@ paths: tags: - startAgentTracker summary: Start a tracker on an agent - description: Ask an agent to start a specified tracker. + description: Submits a request to start a named tracker on the specified agent. Provide the AgentDeviceId and TrackerName in the request body. operationId: StartAgentTracker_Post requestBody: content: @@ -11307,7 +11307,7 @@ paths: tags: - agentServices summary: Get agent running services - description: Get the list of running Services from a specified agent/device. Used to enable 'white - listing' if existing Service from a running agent when building device config. + description: Returns the list of currently running services on the specified agent or device. Use this data to build service allowlists when configuring device tracking templates. operationId: GetAgentServices_Get parameters: - name: AgentDevice @@ -11335,7 +11335,7 @@ paths: tags: - agentServices summary: Get agent running services - description: Get the list of running Services from a specified agent/device. Used to enable 'white - listing' if existing Service from a running agent when building device config. + description: Submits a request to retrieve the list of currently running services from the specified agent or device. Provide the AgentDevice details in the request body. operationId: GetAgentServices_Post requestBody: content: @@ -11359,7 +11359,7 @@ paths: tags: - policyTemplates summary: Set active policy template version - description: Sets a specific version of a named policy template as the active one. + description: Marks the specified version of a named policy template as the active version. Only the active version is used when running compliance checks and tracking reports against devices. operationId: SetActivePolicyTemplateactiveVersion_Get parameters: - name: TemplateName @@ -11390,7 +11390,7 @@ paths: tags: - policyTemplates summary: Set active policy template version - description: Sets a specific version of a named policy template as the active one. + description: Submits a request to set the active version of a named policy template. Provide the TemplateName and ActiveVersion in the request body. operationId: SetActivePolicyTemplateactiveVersion_Post requestBody: content: @@ -11412,7 +11412,7 @@ paths: tags: - policyTemplates summary: Update matching config templates. - description: Update matching config templates. + description: Updates properties across all config templates that match the specified criteria, such as name or usage tags. Use the filtering parameters to target specific templates or versions. operationId: UpdatePolicyTemplatesupdate_Get parameters: - name: Name @@ -11536,7 +11536,7 @@ paths: tags: - policyTemplates summary: Update matching config templates. - description: Update matching config templates. + description: Submits a request to update config templates matching the specified criteria. Provide the matching filters and updated properties in the request body. operationId: UpdatePolicyTemplatesupdate_Post requestBody: content: @@ -11558,7 +11558,7 @@ paths: tags: - deviceConfigTemplate summary: Gets a named device config template. - description: Gets a named device config template. + description: Returns the named device configuration template, including its tracking configuration and rule set. Set IncludeSystemFilters to true to include system-defined filters and path match definitions in the response. operationId: GetDeviceConfigTemplate_Get parameters: - name: Name @@ -11592,7 +11592,7 @@ paths: tags: - deviceConfigTemplate summary: Gets a named device config template. - description: Gets a named device config template. + description: Submits a request to retrieve the named device configuration template. Provide the template Name and IncludeSystemFilters preference in the request body. operationId: GetDeviceConfigTemplate_Post requestBody: content: @@ -11616,7 +11616,7 @@ paths: tags: - deviceConfigTemplateNames summary: 'List device tracking template names' - description: 'Gets a list of device tracking template names, optionally filtering by trackers contained (e.g. find templates with a process tracker).' + description: 'Returns a list of device tracking template names. Use TrackersContained to find only templates that include specific trackers (for example, processtracker), or AgentDeviceIds to find templates currently applied to a specific set of devices.' operationId: GetDeviceConfigTemplateNames_Get parameters: - name: TrackersContained @@ -11658,7 +11658,7 @@ paths: tags: - deviceConfigTemplateNames summary: 'List device tracking template names' - description: 'Gets a list of device tracking template names, optionally filtering by trackers contained (e.g. find templates with a process tracker).' + description: 'Submits a request to retrieve device tracking template names. Provide tracker and device filter criteria in the request body.' operationId: GetDeviceConfigTemplateNames_Post requestBody: content: @@ -11685,7 +11685,7 @@ paths: tags: - addDeviceConfigProcessRules summary: Add process rules to tracking template - description: Adds white/grey/black listing to process rules in the specified device tracking configuration template. + description: Adds allowlist, greylist, or blocklist entries to the process tracking rules in the specified device tracking configuration template. Use this endpoint to configure which processes are permitted, monitored, or blocked on tracked devices. operationId: AddDeviceConfigProcessRules_Get parameters: - name: DeviceTemplateName @@ -11719,7 +11719,7 @@ paths: tags: - addDeviceConfigProcessRules summary: Add process rules to tracking template - description: Adds white/grey/black listing to process rules in the specified device tracking configuration template. + description: Submits a request to add process listing rules to the specified device tracking configuration template. Provide the template name and the list of process rules in the request body. operationId: AddDeviceConfigProcessRules_Post requestBody: content: @@ -11741,7 +11741,7 @@ paths: tags: - groupPolicy summary: Get group policy template - description: Get the configured config policy template for the specified group or by individual template name. + description: Returns the configuration policy templates assigned to the specified group or matching the specified template name. Use GroupNames to query multiple groups in a single request. operationId: GetGroupPolicy_Get parameters: - name: GroupName @@ -11822,7 +11822,7 @@ paths: tags: - groupPolicy summary: Get group policy template - description: Get the configured config policy template for the specified group or by individual template name. + description: Submits a request to retrieve the configuration policy templates assigned to the specified group. Provide the group name or template name in the request body. operationId: GetGroupPolicy_Post requestBody: content: @@ -11846,7 +11846,7 @@ paths: tags: - groupPolicyNames summary: Get group config policy template names - description: Get the configured config policy template names for the specified groups. + description: Returns a mapping of group names to their assigned configuration policy template names. Provide one or more GroupNames to retrieve the template associations for each group. operationId: GetGroupPolicyConfigNames_Get parameters: - name: GroupNames @@ -11883,7 +11883,7 @@ paths: tags: - groupPolicyNames summary: Get group config policy template names - description: Get the configured config policy template names for the specified groups. + description: Submits a request to retrieve configuration policy template name mappings for the specified groups. Provide the GroupNames list in the request body. operationId: GetGroupPolicyConfigNames_Post requestBody: content: @@ -11913,7 +11913,7 @@ paths: tags: - groupPolicy summary: Adds config template to a group. - description: Adds a config template to a group. + description: Associates a configuration policy template with the specified group, making the template active for all devices in that group. Set IsTrusted to true if the template contains trusted commands. operationId: AddGroupPolicyadd_Get parameters: - name: Version @@ -11961,7 +11961,7 @@ paths: tags: - groupPolicy summary: Adds config template to a group. - description: Adds a config template to a group. + description: Submits a request to associate a configuration policy template with the specified group. Provide the group name, template name, and IsTrusted flag in the request body. operationId: AddGroupPolicyadd_Post requestBody: content: @@ -11985,7 +11985,7 @@ paths: tags: - groupPolicy summary: Remove template from group - description: Removes a config template from a group. + description: Removes the association between the specified configuration policy template and the specified group. After removal, devices in the group are no longer governed by this template. operationId: DeleteGroupPolicydelete_Get parameters: - name: GroupName @@ -12016,7 +12016,7 @@ paths: tags: - groupPolicy summary: Remove template from group - description: Removes a config template from a group. + description: Submits a request to remove a configuration policy template from the specified group. Provide the GroupName and PolicyTemplateName in the request body. operationId: DeleteGroupPolicydelete_Post requestBody: content: @@ -12038,7 +12038,7 @@ paths: tags: - reParentDevices summary: Re-parents the given devices to the specified Agent. - description: Re-parents the given devices to the specified Agent. + description: Reassigns the specified devices to a new parent agent. Set MigrateEvents to true to also migrate any existing event history from the old agent-device combination to the new one. operationId: ReParentDevices_Get parameters: - name: Devices @@ -12084,7 +12084,7 @@ paths: tags: - reParentDevices summary: Re-parents the given devices to the specified Agent. - description: Re-parents the given devices to the specified Agent. + description: Submits a request to reassign the specified devices to a new parent agent. Provide the device IDs, target AgentDeviceId, and MigrateEvents flag in the request body. operationId: ReParentDevices_Post requestBody: content: @@ -12112,7 +12112,7 @@ paths: tags: - exportAgents summary: Export a list of agent details. - description: Export a list of agent details. + description: Exports agent details matching the specified device filter to the chosen format, such as Excel, PDF, CSV, or JSON. Use the ReportTitle and TimeZoneId parameters to customise the exported output. operationId: ExportAgents_Get parameters: - name: DeviceFilter @@ -12164,7 +12164,7 @@ paths: tags: - exportAgents summary: Export a list of agent details. - description: Export a list of agent details. + description: Submits a request to export agent details in the specified format. Provide the device filter, export format, report title, and timezone in the request body. operationId: ExportAgents_Post requestBody: content: @@ -12188,7 +12188,7 @@ paths: tags: - agentsRanked summary: List agents by device filter - description: A request to return agents matching the device filter. + description: Returns a paged list of agents matching the specified device filter, ordered by a rank score. Use the optional flags to include related group details, credentials, planned changes, and applied templates in the response. operationId: GetAgentsRanked_Get parameters: - name: DeviceFilter @@ -12286,7 +12286,7 @@ paths: tags: - agentsRanked summary: List agents by device filter - description: A request to return agents matching the device filter. + description: Submits a request to retrieve agents matching the specified device filter. Provide the device filter, related-data flags, and pagination options in the request body. operationId: GetAgentsRanked_Post requestBody: content: @@ -12310,7 +12310,7 @@ paths: tags: - groupMembers summary: List group members by criteria - description: A request to return group members matching the criteria. + description: Returns a paged list of members (devices or child groups) belonging to the specified group. Use MemberType to restrict results to AgentDevice or Group members only. operationId: GroupMembers_Get parameters: - name: GroupName @@ -12388,7 +12388,7 @@ paths: tags: - groupMembers summary: List group members by criteria - description: A request to return group members matching the criteria. + description: Submits a request to retrieve group members matching the specified criteria. Provide the GroupName and MemberType filter in the request body. operationId: GroupMembers_Post requestBody: content: @@ -12412,7 +12412,7 @@ paths: tags: - groups summary: A request to return groups matching the criteria. - description: A request to return groups matching the criteria. + description: Returns a paged list of groups matching the specified criteria, such as internal name, display name, or parent group membership. Use UserName to retrieve groups visible to a specific user. operationId: GetGroups_Get parameters: - name: Name @@ -12509,7 +12509,7 @@ paths: tags: - groups summary: A request to return groups matching the criteria. - description: A request to return groups matching the criteria. + description: Submits a request to retrieve groups matching the specified criteria. Provide name filters, membership filters, and pagination options in the request body. operationId: GetGroups_Post requestBody: content: @@ -12533,7 +12533,7 @@ paths: tags: - groupsTree summary: Get groups hierarchy tree - description: Gets a tree structure representing the groups hierarchy. + description: Returns the complete groups hierarchy as a nested tree structure, showing parent-child relationships between all device groups. Use this endpoint to render group navigation trees in a user interface. operationId: GetGroupsTree_Get responses: '200': @@ -12548,7 +12548,7 @@ paths: tags: - groupsTree summary: Get groups hierarchy tree - description: Gets a tree structure representing the groups hierarchy. + description: Submits a request to retrieve the groups hierarchy tree. Returns the same nested structure as the GET variant. operationId: GetGroupsTree_Post requestBody: content: @@ -12572,7 +12572,7 @@ paths: tags: - groups summary: Delete matching group - description: Represents a request to delete a group matching the criteria. + description: Deletes the group matching the specified internal Name from the system. This action removes the group definition; ensure that no critical device assignments depend on this group before deleting. operationId: DeleteGroupdelete_Get parameters: - name: Name @@ -12598,7 +12598,7 @@ paths: tags: - groups summary: Delete matching group - description: Represents a request to delete a group matching the criteria. + description: Submits a request to delete the specified group. Provide the group's internal Name in the request body. operationId: DeleteGroupdelete_Post requestBody: content: @@ -12620,7 +12620,7 @@ paths: tags: - groups summary: Adds a new Group definition. - description: Adds a new Group definition. + description: Creates a new group of the specified GroupType, optionally placing it under a parent group. Set Members to specify child group members, and assign a RiskScore to weight the group in risk reporting. operationId: AddGroupadd_Get parameters: - name: ParentGroupName @@ -12692,7 +12692,7 @@ paths: tags: - groups summary: Adds a new Group definition. - description: Adds a new Group definition. + description: Submits a request to create a new group. Provide the display name, group type, parent group, members, and risk score in the request body. operationId: AddGroupadd_Post requestBody: content: @@ -12716,7 +12716,7 @@ paths: tags: - groups summary: Updates a Group definition. - description: Updates a Group definition. + description: Updates the display name, child group members, or risk score of the specified group, identified by its internal Name. Provide only the fields you want to change. operationId: UpdateGroupupdate_Get parameters: - name: Name @@ -12761,7 +12761,7 @@ paths: tags: - groups summary: Updates a Group definition. - description: Updates a Group definition. + description: Submits a request to update a group definition. Provide the group Name and the fields to change in the request body. operationId: UpdateGroupupdate_Post requestBody: content: @@ -12783,7 +12783,7 @@ paths: tags: - devices summary: Delete devices to Deleted group - description: Represents a request to delete devices matching the criteria. Note that when a device is deleted it is moved to the Deleted group and is no longer included in the licensed device count. + description: Moves the specified devices to the Deleted group, effectively removing them from the active device inventory. Deleted devices are excluded from the licensed device count. Provide the AgentDeviceIds of the devices to remove. operationId: DeleteDevicesdelete_Get parameters: - name: AgentDeviceIds @@ -12812,7 +12812,7 @@ paths: tags: - devices summary: Delete devices to Deleted group - description: Represents a request to delete devices matching the criteria. Note that when a device is deleted it is moved to the Deleted group and is no longer included in the licensed device count. + description: Submits a request to move the specified devices to the Deleted group. Provide the AgentDeviceIds in the request body. operationId: DeleteDevicesdelete_Post requestBody: content: @@ -12834,7 +12834,7 @@ paths: tags: - devices summary: List overdue devices - description: Gets devices that have not polled in for the specified amount of time. + description: Returns a list of devices that have not checked in for at least the specified number of seconds. Use MemberOfGroups and NotMemberOfGroups to scope the query to specific parts of the device estate. operationId: GetOverdueDevicesoverdue_Get parameters: - name: OfflineSeconds @@ -12881,7 +12881,7 @@ paths: tags: - devices summary: List overdue devices - description: Gets devices that have not polled in for the specified amount of time. + description: Submits a request to retrieve devices that have not polled in within the specified time threshold. Provide the OfflineSeconds and optional group filters in the request body. operationId: GetOverdueDevicesoverdue_Post requestBody: content: @@ -12905,7 +12905,7 @@ paths: tags: - device summary: 'Permanently delete agent (challenge required)' - description: 'Delete the specified Agent from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + description: 'Permanently removes the specified agent from the system. This endpoint uses a two-step challenge-response process: the first call returns a challenge string that must be answered with an authorization code (obtained from NNT Support) on a subsequent call. Once confirmed, the deletion is irreversible.' operationId: DeleteDevicePermanentlydeletePermanently_Get parameters: - name: AgentId @@ -12948,7 +12948,7 @@ paths: tags: - device summary: 'Permanently delete agent (challenge required)' - description: 'Delete the specified Agent from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + description: 'Submits a permanent deletion request for the specified agent. On the first call the system issues a challenge; supply the challenge response code from NNT Support in a second call to confirm. Provide the AgentId, DeviceId, and Response in the request body.' operationId: DeleteDevicePermanentlydeletePermanently_Post requestBody: content: @@ -12972,7 +12972,7 @@ paths: tags: - device summary: Re-register previously deleted devices - description: Represents a request to re-register a list of previously deleted devices matching the criteria. + description: Re-registers one or more previously deleted devices, restoring them to the active device inventory. Provide the AgentDeviceIds of the devices to reinstate. operationId: ReRegisterDevicereRegister_Get parameters: - name: AgentDeviceIds @@ -13001,7 +13001,7 @@ paths: tags: - device summary: Re-register previously deleted devices - description: Represents a request to re-register a list of previously deleted devices matching the criteria. + description: Submits a request to re-register previously deleted devices. Provide the AgentDeviceIds in the request body. operationId: ReRegisterDevicereRegister_Post requestBody: content: @@ -13023,7 +13023,7 @@ paths: tags: - group summary: 'Permanently delete group members' - description: 'Delete all the specified group members from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + description: 'Permanently removes all members of the specified group from the system using a two-step challenge-response process. The first call returns a challenge string; supply the authorization code from NNT Support on a subsequent call to confirm. This action is irreversible.' operationId: DeleteGroupMembersPermanentlydeleteMembersPermanently_Get parameters: - name: GroupName @@ -13056,7 +13056,7 @@ paths: tags: - group summary: 'Permanently delete group members' - description: 'Delete all the specified group members from the system. On first call the system will issue a challenge which must be answered and the response supplied on a repetition of the initial request. Contact NNT Support, supplying the text of the challenge, in order be be issued with an authorising response code.' + description: 'Submits a request to permanently delete all members of the specified group. On the first call the system issues a challenge; supply the authorization code from NNT Support in a second call to confirm. Provide the GroupName and Response in the request body.' operationId: DeleteGroupMembersPermanentlydeleteMembersPermanently_Post requestBody: content: @@ -13080,7 +13080,7 @@ paths: tags: - deviceFilter summary: Add DeviceFilter - description: Represents a request to add a DeviceFilter. + description: Creates a new DeviceFilter definition and adds it to the system. DeviceFilters are reusable device selection criteria that can be referenced by reports and other API calls. Returns the updated list of device filters. operationId: AddDeviceFilteradd_Get parameters: - name: DeviceFilter @@ -13108,7 +13108,7 @@ paths: tags: - deviceFilter summary: Add DeviceFilter - description: Represents a request to add a DeviceFilter. + description: Submits a request to create a new DeviceFilter. Provide the DeviceFilter definition in the request body. Returns the updated list of device filters. operationId: AddDeviceFilteradd_Post requestBody: content: @@ -13132,7 +13132,7 @@ paths: tags: - deviceFilter summary: Update DeviceFilter by ID - description: Represents a request to update a DeviceFilter matching the given id. + description: Updates the DeviceFilter identified by the specified Name with a new filter definition. Returns the updated list of device filters. operationId: UpdateDeviceFilterupdate_Get parameters: - name: Name @@ -13165,7 +13165,7 @@ paths: tags: - deviceFilter summary: Update DeviceFilter by ID - description: Represents a request to update a DeviceFilter matching the given id. + description: Submits a request to update an existing DeviceFilter. Provide the filter Name and new DeviceFilter definition in the request body. operationId: UpdateDeviceFilterupdate_Post requestBody: content: @@ -13189,7 +13189,7 @@ paths: tags: - deviceFilter summary: 'Promote device filter to head' - description: 'Represents a request to bring the named filter to the head of the list, or to create it at the head of the list if it doesn''t exist.' + description: Moves the specified DeviceFilter to the top of the filter list, or creates it at the top of the list if it does not already exist. Use this endpoint to retrieve the current promotion state of a filter. operationId: PromoteDeviceFilterpromote_Get parameters: - name: DeviceFilter @@ -13217,7 +13217,7 @@ paths: tags: - deviceFilter summary: 'Promote device filter to head' - description: 'Represents a request to bring the named filter to the head of the list, or to create it at the head of the list if it doesn''t exist.' + description: Submits a request to promote the specified DeviceFilter to the head of the list, creating it if it does not already exist. Provide the DeviceFilter definition in the request body. operationId: PromoteDeviceFilterpromote_Post requestBody: content: @@ -13241,7 +13241,7 @@ paths: tags: - deviceFilter summary: Delete matching DeviceFilter - description: Represents a request to delete a DeviceFilter matching the criteria. + description: Deletes the DeviceFilter matching the specified Name from the system. Returns no content on success. operationId: DeleteDeviceFilterdelete_Get parameters: - name: Name @@ -13267,7 +13267,7 @@ paths: tags: - deviceFilter summary: Delete matching DeviceFilter - description: Represents a request to delete a DeviceFilter matching the criteria. + description: Submits a request to delete the DeviceFilter matching the specified Name. Provide the filter Name in the request body. operationId: DeleteDeviceFilterdelete_Post requestBody: content: @@ -13289,7 +13289,7 @@ paths: tags: - deviceFilters summary: List DeviceFilter definitions - description: Returns a paged list of DeviceFilter definitions matching the optional name criteria. + description: Returns a paged list of DeviceFilter definitions, optionally filtered by an exact Name or a partial name match using NameContains. Use Skip and Take to paginate through large result sets. operationId: GetDeviceFilters_Get parameters: - name: NameContains @@ -13362,7 +13362,7 @@ paths: tags: - deviceFilters summary: List DeviceFilter definitions - description: Returns a paged list of DeviceFilter definitions matching the optional name criteria. + description: Submits a request to retrieve DeviceFilter definitions. Provide optional name filters and pagination parameters in the request body. operationId: GetDeviceFilters_Post requestBody: content: @@ -13386,7 +13386,7 @@ paths: tags: - groupMembers summary: Add members to named group - description: A request to add the specified Groups and Agents group members to the named group. + description: Adds one or more child groups or agent devices as members of the specified parent group, identified by GroupName. Provide the Groups names and/or AgentDeviceIds to add. operationId: AddGroupMembersadd_Get parameters: - name: GroupName @@ -13436,7 +13436,7 @@ paths: tags: - groupMembers summary: Add members to named group - description: A request to add the specified Groups and Agents group members to the named group. + description: Submits a request to add groups or devices as members of the specified group. Provide the GroupName, Groups, and AgentDeviceIds in the request body. operationId: AddGroupMembersadd_Post requestBody: content: @@ -13458,7 +13458,7 @@ paths: tags: - groupMembers summary: Remove members from named group - description: A request to remove group or device members from the named group. + description: Removes one or more child groups or agent devices from the specified parent group, identified by GroupName. Provide the Groups names and/or AgentDeviceIds to remove. operationId: DeleteGroupMembersdelete_Get parameters: - name: GroupName @@ -13500,7 +13500,7 @@ paths: tags: - groupMembers summary: Remove members from named group - description: A request to remove group or device members from the named group. + description: Submits a request to remove groups or devices from the specified group. Provide the GroupName, Groups, and AgentDeviceIds in the request body. operationId: DeleteGroupMembersdelete_Post requestBody: content: @@ -13522,7 +13522,7 @@ paths: tags: - deviceOnlineStatus summary: Get device online/offline status - description: Gets an indication of the device's online/offline status + description: Returns the current online or offline status of the specified device, identified by AgentId and DeviceId. Use this endpoint to check whether an agent is actively communicating with the hub. operationId: GetDeviceOnlineStatus_Get parameters: - name: AgentId @@ -13556,7 +13556,7 @@ paths: tags: - deviceOnlineStatus summary: Get device online/offline status - description: Gets an indication of the device's online/offline status + description: Submits a request to retrieve the online or offline status of the specified device. Provide the AgentId and DeviceId in the request body. operationId: GetDeviceOnlineStatus_Post requestBody: content: @@ -13581,7 +13581,7 @@ paths: tags: - deviceSettings summary: 'Get device settings with overrides' - description: 'Gets the device settings for the device, based on the global device settings and any device specific overrides.' + description: 'Returns the effective device settings for the specified device or group, combining the global default settings with any device-specific overrides. Provide either AgentId and DeviceId, or GroupName, to identify the target.' operationId: UpdateDeviceSettingsupdate_Get parameters: - name: AgentId @@ -13624,7 +13624,7 @@ paths: tags: - deviceSettings summary: 'Get device settings with overrides' - description: 'Gets the device settings for the device, based on the global device settings and any device specific overrides.' + description: 'Submits a request to retrieve the effective device settings for the specified device or group. Provide the AgentId, DeviceId, or GroupName in the request body.' operationId: UpdateDeviceSettingsupdate_Post requestBody: content: @@ -13648,7 +13648,7 @@ paths: tags: - deviceCredentials summary: Associate credentials with agent - description: A request to associate named credentials with an agent. + description: Associates the specified named credentials with an agent device, enabling the hub to use those credentials when polling or proxying the device. Provide the AgentDevice and CredentialsKey to link them. operationId: AddCredentialsToAgentDeviceadd_Get parameters: - name: AgentDevice @@ -13679,7 +13679,7 @@ paths: tags: - deviceCredentials summary: Associate credentials with agent - description: A request to associate named credentials with an agent. + description: Submits a request to associate named credentials with an agent device. Provide the AgentDevice and CredentialsKey in the request body. operationId: AddCredentialsToAgentDeviceadd_Post requestBody: content: @@ -13701,7 +13701,7 @@ paths: tags: - deviceCredentials summary: Remove agent credentials - description: A request to remove named credentials from an agent. + description: Removes the specified named credentials from the specified agent device, disassociating them so they are no longer used for polling or proxying. Provide the AgentDevice and CredentialKey to remove. operationId: RemoveCredentialsFromAgentDevicedelete_Get parameters: - name: AgentDevice @@ -13732,7 +13732,7 @@ paths: tags: - deviceCredentials summary: Remove agent credentials - description: A request to remove named credentials from an agent. + description: Submits a request to remove named credentials from an agent device. Provide the AgentDevice and CredentialKey in the request body. operationId: RemoveCredentialsFromAgentDevicedelete_Post requestBody: content: @@ -13754,7 +13754,7 @@ paths: tags: - deviceName summary: Update agent display name - description: A request to update the display name of an agent. + description: Updates the display name shown for the specified agent device in reports and the user interface. Provide the AgentDevice and the new DeviceName. operationId: SetAgentDeviceNameupdate_Get parameters: - name: AgentDevice @@ -13785,7 +13785,7 @@ paths: tags: - deviceName summary: Update agent display name - description: A request to update the display name of an agent. + description: Submits a request to update the display name of an agent device. Provide the AgentDevice and new DeviceName in the request body. operationId: SetAgentDeviceNameupdate_Post requestBody: content: @@ -13807,7 +13807,7 @@ paths: tags: - deviceHostType summary: Update agent host type - description: A request to update the host type of an agent. + description: Updates the host type classification of the specified agent device, such as Windows, Unix, Network, or Cloud. The host type determines which tracking and policy templates are applicable. operationId: SetAgentHostTypeupdate_Get parameters: - name: AgentDevice @@ -13841,7 +13841,7 @@ paths: tags: - deviceHostType summary: Update agent host type - description: A request to update the host type of an agent. + description: Submits a request to update the host type of an agent device. Provide the AgentDevice and the new HostType in the request body. operationId: SetAgentHostTypeupdate_Post requestBody: content: @@ -13863,7 +13863,7 @@ paths: tags: - testAgentCredentials summary: Test proxied device credentials - description: Ask an agent to test the credentials for a device it is proxying. + description: Instructs the specified agent to test the credentials configured for one of the devices it proxies, confirming whether the credentials are valid and the device is reachable. Returns the test result. operationId: TestAgentCredentials_Get parameters: - name: AgentDeviceId @@ -13891,7 +13891,7 @@ paths: tags: - testAgentCredentials summary: Test proxied device credentials - description: Ask an agent to test the credentials for a device it is proxying. + description: Submits a request for an agent to test credentials for a proxied device. Provide the AgentDeviceId in the request body. operationId: TestAgentCredentials_Post requestBody: content: @@ -13915,7 +13915,7 @@ paths: tags: - ipBlocking summary: List blocked IP addresses - description: Gets details of ip addresses that have been blocked. + description: Returns the list of IP addresses that are currently blocked, together with their blocking status and expiry times. Use this endpoint to audit which addresses have been manually blocked. operationId: GetIpBlocking_Get parameters: - name: Version @@ -13941,7 +13941,7 @@ paths: tags: - ipBlocking summary: List blocked IP addresses - description: Gets details of ip addresses that have been blocked. + description: Submits a request to retrieve the list of currently blocked IP addresses and their blocking details. operationId: GetIpBlocking_Post requestBody: content: @@ -13968,7 +13968,7 @@ paths: tags: - ipBlocking summary: Block IP address until time - description: Adds manual blocking of a specified ip address until a specified time. + description: Manually blocks the specified IP address until the given UTC expiry time. After the expiry time the block is automatically lifted. Returns the updated list of blocked IP addresses. operationId: AddIpBlockingadd_Get parameters: - name: IpAddress @@ -14006,7 +14006,7 @@ paths: tags: - ipBlocking summary: Block IP address until time - description: Adds manual blocking of a specified ip address until a specified time. + description: Submits a request to manually block the specified IP address until the given expiry time. Provide the IpAddress and ExpiresUtc in the request body. operationId: AddIpBlockingadd_Post requestBody: content: @@ -14033,7 +14033,7 @@ paths: tags: - ipBlocking summary: Removes blocking of a specified ip address. - description: Removes blocking of a specified ip address. + description: Removes the block on the specified IP address, immediately allowing connections from that address. Returns the updated list of blocked IP addresses. operationId: DeleteIpBlockingdelete_Get parameters: - name: IpAddress @@ -14064,7 +14064,7 @@ paths: tags: - ipBlocking summary: Removes blocking of a specified ip address. - description: Removes blocking of a specified ip address. + description: Submits a request to remove the block on the specified IP address. Provide the IpAddress in the request body. operationId: DeleteIpBlockingdelete_Post requestBody: content: @@ -14091,7 +14091,7 @@ paths: tags: - discoverDevices summary: Discover proxied devices - description: Discovers devices to be added as proxied devices to a master device. + description: Triggers device discovery to identify candidate devices that can be added as proxied devices under a master agent. Returns discovered device information for review before adding them to the inventory. operationId: DiscoverDevices_Get parameters: - name: Version @@ -14114,7 +14114,7 @@ paths: tags: - discoverDevices summary: Discover proxied devices - description: Discovers devices to be added as proxied devices to a master device. + description: Submits a device discovery request to identify candidate proxied devices for a master agent. Provide the discovery criteria in the request body. operationId: DiscoverDevices_Post requestBody: content: @@ -14138,7 +14138,7 @@ paths: tags: - discoveredDevices summary: Submit discovered devices - description: Submits discovered devices as a response to a DiscoverDevices request. + description: Submits the list of discovered devices back to the hub as a response to a previous DiscoverDevices request, registering them as proxied devices under the master agent. operationId: SubmitDiscoveredDevices_Get parameters: - name: Version @@ -14159,7 +14159,7 @@ paths: tags: - discoveredDevices summary: Submit discovered devices - description: Submits discovered devices as a response to a DiscoverDevices request. + description: Submits the list of discovered devices to register them as proxied devices. Provide the discovered device details in the request body. operationId: SubmitDiscoveredDevices_Post requestBody: content: @@ -14181,7 +14181,7 @@ paths: tags: - acknowledgeEvents summary: Acknowledge events as planned - description: Acknowledge a list of events as 'planned'. + description: Updates the status of the specified events to the given NewStatus (for example, Planned or Acknowledged), optionally linking them to a planned change instance. Use the EventIds, DeviceFilter, and EventFilter parameters to target specific events. operationId: AcknowledgeEvents_Get parameters: - name: EventIds @@ -14255,7 +14255,7 @@ paths: tags: - acknowledgeEvents summary: Acknowledge events as planned - description: Acknowledge a list of events as 'planned'. + description: Submits a request to update the status of the specified events. Provide the EventIds or event filter criteria, the PlannedChangeId, and the NewStatus in the request body. operationId: AcknowledgeEvents_Post requestBody: content: @@ -14277,7 +14277,7 @@ paths: tags: - resubmitEvents summary: 'Resubmit events to pipeline' - description: 'Re-submit the specified events (i.e for re-consideration by the pipeline re: planned changes).' + description: 'Re-submits the specified events to the processing pipeline for re-evaluation against planned change rules. Use this endpoint after creating or modifying planned changes to update the status of previously processed events.' operationId: ResubmitEvents_Get parameters: - name: GetEvents @@ -14303,7 +14303,7 @@ paths: tags: - resubmitEvents summary: 'Resubmit events to pipeline' - description: 'Re-submit the specified events (i.e for re-consideration by the pipeline re: planned changes).' + description: 'Submits a request to re-process the specified events through the planned change pipeline. Provide the event selection criteria in the request body.' operationId: ResubmitEvents_Post requestBody: content: @@ -14325,7 +14325,7 @@ paths: tags: - event summary: Get event history - description: Get the event history for one specific event. + description: Returns the full history of a specific event, identified by EventId, including all status changes and acknowledgements over time. Use this endpoint to audit the lifecycle of an individual change event. operationId: GetEventHistoryhistoryEventId_Get parameters: - name: EventId @@ -14353,7 +14353,7 @@ paths: tags: - event summary: Get event history - description: Get the event history for one specific event. + description: Submits a request to retrieve the history of a specific event. Provide the EventId in the request body. operationId: GetEventHistoryhistoryEventId_Post requestBody: content: @@ -14377,7 +14377,7 @@ paths: tags: - eventDeviceGroups summary: 'Get device groups for events' - description: 'Gets the list of groups that the devices associated with the given events are members of. If Intersection is true, only the groups of which all devices are a member are returned. This function is used to determine the possible groups to associate a new planned change with, such that the events will be covered by it.' + description: 'Returns the groups associated with the devices of the specified events, enabling you to determine which groups a new planned change must target to cover those events. Set Intersection to true to return only groups common to all event devices; set it to false to return the union of all groups.' operationId: GetEventDeviceGroups_Get parameters: - name: EventIds @@ -14450,7 +14450,7 @@ paths: tags: - eventDeviceGroups summary: 'Get device groups for events' - description: 'Gets the list of groups that the devices associated with the given events are members of. If Intersection is true, only the groups of which all devices are a member are returned. This function is used to determine the possible groups to associate a new planned change with, such that the events will be covered by it.' + description: 'Submits a request to retrieve the groups associated with the devices of the specified events. Provide the EventIds, Intersection flag, and optional device and event filters in the request body.' operationId: GetEventDeviceGroups_Post requestBody: content: @@ -14474,7 +14474,7 @@ paths: tags: - setCommentsForEvents summary: Set comments for events - description: Set comments for events + description: Sets a comment on the events matching the specified filter criteria. Use the GetEvents filter to target specific events and provide the Comment text to attach. operationId: SetCommentForEvents_Get parameters: - name: GetEvents @@ -14505,7 +14505,7 @@ paths: tags: - setCommentsForEvents summary: Set comments for events - description: Set comments for events + description: Submits a request to set a comment on the events matching the specified criteria. Provide the event filter and comment text in the request body. operationId: SetCommentForEvents_Post requestBody: content: @@ -14527,7 +14527,7 @@ paths: tags: - inventory summary: List inventory items - description: Retrieves a list of inventory items from the hub service. + description: Returns a paged list of inventory items from the hub. Use the Sort, Skip, Take, and GenericFilters parameters to control ordering and pagination of the results. operationId: GetInventory_Get parameters: - name: CountOnly @@ -14590,7 +14590,7 @@ paths: tags: - inventory summary: List inventory items - description: Retrieves a list of inventory items from the hub service. + description: Submits a request to retrieve inventory items from the hub. Provide pagination and filtering options in the request body. operationId: GetInventory_Post requestBody: content: @@ -14614,7 +14614,7 @@ paths: tags: - agentInventoryGrouped summary: List grouped agent inventory items - description: Retrieves a list of agent inventory items grouped by their inventory item ids from the hub service. + description: Returns a paged list of agent inventory items grouped by inventory item ID, allowing you to see how many agents share each item. Use the DeviceFilter to restrict results to specific agents or groups. operationId: GetAgentInventoryItemsGrouped_Get parameters: - name: DeviceFilter @@ -14682,7 +14682,7 @@ paths: tags: - agentInventoryGrouped summary: List grouped agent inventory items - description: Retrieves a list of agent inventory items grouped by their inventory item ids from the hub service. + description: Submits a request to retrieve agent inventory items grouped by inventory item ID. Provide the DeviceFilter and pagination options in the request body. operationId: GetAgentInventoryItemsGrouped_Post requestBody: content: @@ -14706,7 +14706,7 @@ paths: tags: - agentInventoryAgentsDetail summary: List agents by inventory item ID - description: Retrieves a list of agents with a specific inventory item id from the hub service. + description: Returns a paged list of agents that have a specific inventory item, filtered by device filter criteria. Use this endpoint to find which agents have a particular software package or hardware component installed. operationId: GetAgentInventoryAgentsDetail_Get parameters: - name: DeviceFilter @@ -14774,7 +14774,7 @@ paths: tags: - agentInventoryAgentsDetail summary: List agents by inventory item ID - description: Retrieves a list of agents with a specific inventory item id from the hub service. + description: Submits a request to retrieve agents with a specific inventory item. Provide the DeviceFilter and inventory item criteria in the request body. operationId: GetAgentInventoryAgentsDetail_Post requestBody: content: @@ -14798,7 +14798,7 @@ paths: tags: - inventory summary: Get vulnerability overview by filter - description: A request to return the vulnerability overview matching the device filter. + description: Returns an aggregated vulnerability overview for devices matching the specified device filter, including severity counts and change trends since the given start date. Set ShowIgnored to true to include suppressed CVEs in the statistics. operationId: GetVulnerabilityOverviewvulnerabilityOverview_Get parameters: - name: DeviceFilter @@ -14885,7 +14885,7 @@ paths: tags: - inventory summary: Get vulnerability overview by filter - description: A request to return the vulnerability overview matching the device filter. + description: Submits a request to retrieve an aggregated vulnerability overview. Provide the DeviceFilter, start date, and ShowIgnored preference in the request body. operationId: GetVulnerabilityOverviewvulnerabilityOverview_Post requestBody: content: @@ -14909,7 +14909,7 @@ paths: tags: - inventory summary: Get estate vulnerabilities by filter - description: A request to return the vulnerabilities in an estate matching the device and vulnerability filters. + description: Returns a paged list of vulnerabilities affecting the devices in the estate that match the specified device and vulnerability filters. Use this endpoint to audit CVE exposure across your environment. operationId: GetVulnerabilityvulnerabilities_Get parameters: - name: DeviceFilter @@ -14977,7 +14977,7 @@ paths: tags: - inventory summary: Get estate vulnerabilities by filter - description: A request to return the vulnerabilities in an estate matching the device and vulnerability filters. + description: Submits a request to retrieve vulnerabilities matching the specified device and vulnerability filters. Provide the filter criteria and pagination options in the request body. operationId: GetVulnerabilityvulnerabilities_Post requestBody: content: @@ -15001,7 +15001,7 @@ paths: tags: - inventory summary: Get software vulnerabilities by filter - description: A request to return the software vulnerability matching the device filter. + description: Returns software vulnerability information for devices matching the specified device filter, showing CVE exposure per software package since the given start date. Use this endpoint to identify vulnerable software across your estate. operationId: GetSoftwareVulnerabilitysoftwareVulnerability_Get parameters: - name: DeviceFilter @@ -15076,7 +15076,7 @@ paths: tags: - inventory summary: Get software vulnerabilities by filter - description: A request to return the software vulnerability matching the device filter. + description: Submits a request to retrieve software vulnerability information for devices matching the specified filter. Provide the DeviceFilter and start date in the request body. operationId: GetSoftwareVulnerabilitysoftwareVulnerability_Post requestBody: content: @@ -15100,7 +15100,7 @@ paths: tags: - inventory summary: Mark inventory item for update - description: Marks an inventory item a requiring an update / refresh. + description: Marks one or more inventory items as requiring a refresh, prompting agents to re-collect the relevant inventory data on their next polling cycle. operationId: MarkInventoryItemsRequiringUpdateupdate_Get parameters: - name: Version @@ -15123,7 +15123,7 @@ paths: tags: - inventory summary: Mark inventory item for update - description: Marks an inventory item a requiring an update / refresh. + description: Submits a request to mark inventory items as requiring an update. Provide the item criteria in the request body. operationId: MarkInventoryItemsRequiringUpdateupdate_Post requestBody: content: @@ -15147,7 +15147,7 @@ paths: tags: - inventory summary: Get software vulnerabilities by filter - description: A request to return the software vulnerability matching the device filter. + description: Returns detailed vulnerability information for the specified software item or CPE name, including associated CVE records and severity scores. Use SoftwareId or CpeName to identify the software package. operationId: GetSoftwareVulnerabilityDetailsoftwareVulnerabilityDetail_Get parameters: - name: SoftwareId @@ -15220,7 +15220,7 @@ paths: tags: - inventory summary: Get software vulnerabilities by filter - description: A request to return the software vulnerability matching the device filter. + description: Submits a request to retrieve detailed vulnerability information for the specified software item or CPE name. Provide the SoftwareId or CpeName in the request body. operationId: GetSoftwareVulnerabilityDetailsoftwareVulnerabilityDetail_Post requestBody: content: @@ -15244,7 +15244,7 @@ paths: tags: - inventory summary: Get device vulnerabilities by filter - description: A request to return the device vulnerability matching the device filter. + description: Returns vulnerability information for devices matching the specified device filter, showing the CVEs affecting each device since the given start date. Use this endpoint to assess the vulnerability posture of specific devices or groups. operationId: GetDeviceVulnerabilitydeviceVulnerability_Get parameters: - name: DeviceFilter @@ -15319,7 +15319,7 @@ paths: tags: - inventory summary: Get device vulnerabilities by filter - description: A request to return the device vulnerability matching the device filter. + description: Submits a request to retrieve device vulnerability information. Provide the DeviceFilter and start date in the request body. operationId: GetDeviceVulnerabilitydeviceVulnerability_Post requestBody: content: @@ -15343,7 +15343,7 @@ paths: tags: - inventory summary: Get device vulnerabilities by filter - description: A request to return the device vulnerability matching the device filter. + description: Returns a detailed list of vulnerabilities for the specified agent device, identified by AgentDeviceId. Use this endpoint to drill into the full CVE exposure for a single device. operationId: GetDeviceVulnerabilityDetaildeviceVulnerabilityDetail_Get parameters: - name: AgentDeviceId @@ -15411,7 +15411,7 @@ paths: tags: - inventory summary: Get device vulnerabilities by filter - description: A request to return the device vulnerability matching the device filter. + description: Submits a request to retrieve detailed vulnerability information for the specified device. Provide the AgentDeviceId and pagination options in the request body. operationId: GetDeviceVulnerabilityDetaildeviceVulnerabilityDetail_Post requestBody: content: @@ -15435,7 +15435,7 @@ paths: tags: - inventory summary: Get related CVEs for CPE - description: Get a list of CVEs that are related to the specified CPE but not directly (e.g previous versions etc) + description: Returns a list of CVEs that are indirectly related to the specified CPE, such as those affecting previous versions of the same software. Provide a CpeName or InventoryItemId to identify the software package. operationId: GetCvesForRelatedCpesrelatedSoftwareVulnerabilityDetail_Get parameters: - name: CpeName @@ -15474,7 +15474,7 @@ paths: tags: - inventory summary: Get related CVEs for CPE - description: Get a list of CVEs that are related to the specified CPE but not directly (e.g previous versions etc) + description: Submits a request to retrieve CVEs indirectly related to the specified CPE. Provide the CpeName or InventoryItemId and result limit options in the request body. operationId: GetCvesForRelatedCpesrelatedSoftwareVulnerabilityDetail_Post parameters: - name: CpeName @@ -15522,7 +15522,7 @@ paths: tags: - inventory summary: Get vulnerable devices by CVE - description: A request to return the vulnerable devices matching the CVE. + description: Returns a paged list of devices that are vulnerable to the specified CVE, identified by CveId. Use this endpoint to identify which devices in your estate require remediation for a specific vulnerability. operationId: GetVulnerableDeviceDetailvulnerableDeviceDetail_Get parameters: - name: CveId @@ -15590,7 +15590,7 @@ paths: tags: - inventory summary: Get vulnerable devices by CVE - description: A request to return the vulnerable devices matching the CVE. + description: Submits a request to retrieve devices affected by the specified CVE. Provide the CveId and pagination options in the request body. operationId: GetVulnerableDeviceDetailvulnerableDeviceDetail_Post requestBody: content: @@ -15614,7 +15614,7 @@ paths: tags: - inventory summary: Ignore CVEs until given date - description: A request to ignore one or more Cves until a given data. + description: Suppresses one or more CVEs until the specified date, excluding them from vulnerability counts and reports. Use this endpoint to acknowledge accepted risks or temporarily dismiss false positives. operationId: IgnoreCveItemignoreCves_Get parameters: - name: Version @@ -15637,7 +15637,7 @@ paths: tags: - inventory summary: Ignore CVEs until given date - description: A request to ignore one or more Cves until a given data. + description: Submits a request to suppress one or more CVEs until the specified date. Provide the CVE IDs and suppression expiry date in the request body. operationId: IgnoreCveItemignoreCves_Post requestBody: content: @@ -15661,7 +15661,7 @@ paths: tags: - vulnerabilityscanstatus summary: Get vulnerability scan status - description: A request to return the software vulnerability scan status. + description: Returns the current status of the software vulnerability scanner, including when each device was last scanned and whether any scans are pending. Use this endpoint to monitor scan coverage across your estate. operationId: GetVulnerabilityScanStatus_Get parameters: - name: CountOnly @@ -15724,7 +15724,7 @@ paths: tags: - vulnerabilityscanstatus summary: Get vulnerability scan status - description: A request to return the software vulnerability scan status. + description: Submits a request to retrieve the software vulnerability scan status. Provide pagination and filter options in the request body. operationId: GetVulnerabilityScanStatus_Post requestBody: content: @@ -15748,7 +15748,7 @@ paths: tags: - log4netConfigs summary: List log4net logger configurations - description: Retrieves a list of log4net logger configurations + description: Returns all log4net logger configurations currently active on the hub, including logger names and log levels. Use this endpoint to review diagnostic logging settings. operationId: GetAllLog4NetConfigItemsall_Get responses: '200': @@ -15763,7 +15763,7 @@ paths: tags: - log4netConfigs summary: List log4net logger configurations - description: Retrieves a list of log4net logger configurations + description: Submits a request to retrieve all log4net logger configurations. Returns the same data as the GET variant. operationId: GetAllLog4NetConfigItemsall_Post requestBody: content: @@ -15880,7 +15880,7 @@ paths: tags: - log4netConfigs summary: List log4net logger configurations with pagination support. - description: Retrieves a list of log4net logger configurations with pagination support. + description: Returns a paged list of log4net logger configurations with support for sorting and filtering. Use the Skip and Take parameters to paginate through the results. operationId: GetLog4NetConfigItems_Get parameters: - name: CountOnly @@ -15943,7 +15943,7 @@ paths: tags: - log4netConfigs summary: List log4net logger configurations with pagination support. - description: Retrieves a list of log4net logger configurations with pagination support. + description: Submits a request to retrieve log4net logger configurations with pagination support. Provide pagination and filter options in the request body. operationId: GetLog4NetConfigItems_Post requestBody: content: @@ -15967,7 +15967,7 @@ paths: tags: - reportDescription summary: Get report description - description: Returns a description for the specified report. + description: Returns a human-readable description for the specified report, including its purpose and what it covers. Use this endpoint to display report metadata to users before they run or view a report. operationId: GetReportDescription_Get parameters: - name: Version @@ -15990,7 +15990,7 @@ paths: tags: - reportDescription summary: Get report description - description: Returns a description for the specified report. + description: Submits a request to retrieve the description for the specified report. Provide the report identifier in the request body. operationId: GetReportDescription_Post requestBody: content: @@ -16014,7 +16014,7 @@ paths: tags: - reportDifferences summary: Differences between two report runs - description: Get a list of differences between two reports runs. + description: Returns the list of differences between two consecutive report runs, showing which items changed between the two executions. Use this endpoint to analyse what changed between compliance or baseline scans. operationId: GetReportChangeDetails_Get parameters: - name: Version @@ -16040,7 +16040,7 @@ paths: tags: - reportDifferences summary: Differences between two report runs - description: Get a list of differences between two reports runs. + description: Submits a request to retrieve the differences between two report runs. Provide the report run identifiers in the request body. operationId: GetReportChangeDetails_Post requestBody: content: @@ -16067,7 +16067,7 @@ paths: tags: - reportData summary: 'Get report results' - description: 'Gets report results for the specified agent, device or task id.' + description: 'Returns a paged list of report results for the specified report, identified by reportId. Use the Sort, Skip, Take, and GenericFilters parameters to control the order and scope of the returned results.' operationId: GetReportDatareportId_Get parameters: - name: CountOnly @@ -16130,7 +16130,7 @@ paths: tags: - reportData summary: 'Get report results' - description: 'Gets report results for the specified agent, device or task id.' + description: 'Submits a request to retrieve report results for the specified report. Provide the reportId and pagination options in the request body.' operationId: GetReportDatareportId_Post requestBody: content: @@ -16154,7 +16154,7 @@ paths: tags: - availableReports summary: 'List available reports' - description: ' Gets a list of available reports for a specified group or agent.' + description: 'Returns a list of available reports for the specified group or agent, optionally filtered by date range. Use this endpoint to discover which reports have been run and are available to view.' operationId: GetAvailableReports_Get parameters: - name: DeviceFilter @@ -16194,7 +16194,7 @@ paths: tags: - availableReports summary: 'List available reports' - description: ' Gets a list of available reports for a specified group or agent.' + description: 'Submits a request to retrieve available reports for the specified group or agent. Provide the DeviceFilter and optional date range in the request body.' operationId: GetAvailableReports_Post requestBody: content: @@ -16218,7 +16218,7 @@ paths: tags: - userDashboard summary: Gets the user dashboard widget layout. - description: Gets the user dashboard widget layout. + description: Returns the saved dashboard widget layout for the authenticated user, identified by dashboard ID. Use this endpoint to restore a user's previously configured dashboard arrangement. operationId: GetUserDashboard_Get parameters: - name: Id @@ -16246,7 +16246,7 @@ paths: tags: - userDashboard summary: Gets the user dashboard widget layout. - description: Gets the user dashboard widget layout. + description: Submits a request to retrieve the user's dashboard widget layout by ID. Provide the dashboard Id in the request body. operationId: GetUserDashboard_Post requestBody: content: @@ -16270,7 +16270,7 @@ paths: tags: - userDashboard summary: Get dashboard widget layout by name - description: Gets the user dashboard widget layout by name. + description: Returns the saved dashboard widget layout for the authenticated user, looked up by dashboard name. Use this endpoint when the dashboard name is known but the ID is not. operationId: GetUserDashboardByNamenamed_Get parameters: - name: Name @@ -16298,7 +16298,7 @@ paths: tags: - userDashboard summary: Get dashboard widget layout by name - description: Gets the user dashboard widget layout by name. + description: Submits a request to retrieve the user's dashboard widget layout by name. Provide the dashboard Name in the request body. operationId: GetUserDashboardByNamenamed_Post requestBody: content: @@ -16322,7 +16322,7 @@ paths: tags: - userDashboard summary: Stores the user dashboard widget layout. - description: Stores the user dashboard widget layout. + description: Saves the user's dashboard widget layout, including the dashboard name and widget positions. If an ID is supplied the existing layout is updated; otherwise a new layout is created. Returns the saved layout details. operationId: SaveUserDashboardsave_Get parameters: - name: Id @@ -16363,7 +16363,7 @@ paths: tags: - userDashboard summary: Stores the user dashboard widget layout. - description: Stores the user dashboard widget layout. + description: Submits a request to save the user's dashboard widget layout. Provide the dashboard ID, name, and widget list in the request body. operationId: SaveUserDashboardsave_Post requestBody: content: @@ -16387,7 +16387,7 @@ paths: tags: - userDashboard summary: Deletes the user dashboard widget layout. - description: Deletes the user dashboard widget layout. + description: Deletes the saved dashboard widget layout identified by the given ID. This removes the layout permanently and cannot be undone. operationId: DeleteUserDashboarddelete_Get parameters: - name: Id @@ -16413,7 +16413,7 @@ paths: tags: - userDashboard summary: Deletes the user dashboard widget layout. - description: Deletes the user dashboard widget layout. + description: Submits a request to delete the specified dashboard widget layout. Provide the dashboard Id in the request body. operationId: DeleteUserDashboarddelete_Post requestBody: content: @@ -16435,7 +16435,7 @@ paths: tags: - userSettings summary: Gets the user settings and selections. - description: Gets the user settings and selections. + description: Returns the saved settings and preferences for the authenticated user, including default dashboard, theme, and welcome popup preferences. operationId: GetUserSettings_Get parameters: - name: Version @@ -16458,7 +16458,7 @@ paths: tags: - userSettings summary: Gets the user settings and selections. - description: Gets the user settings and selections. + description: Submits a request to retrieve the authenticated user's settings and preferences. operationId: GetUserSettings_Post requestBody: content: @@ -16482,7 +16482,7 @@ paths: tags: - userSettings summary: Stores the user settings and selections. - description: Stores the user settings and selections. + description: Saves the authenticated user's settings and preferences, including the default dashboard ID, theme, and whether to skip the welcome wizard on next login. operationId: SaveUserSettingssave_Get parameters: - name: DashboardId @@ -16520,7 +16520,7 @@ paths: tags: - userSettings summary: Stores the user settings and selections. - description: Stores the user settings and selections. + description: Submits a request to save the authenticated user's settings and preferences. Provide the DashboardId, ThemeId, and HideWelcomePopup flag in the request body. operationId: SaveUserSettingssave_Post requestBody: content: @@ -16544,7 +16544,7 @@ paths: tags: - dashboard summary: Gets the dashboard widgets. - description: Gets the dashboard widgets. + description: Returns the available dashboard widget templates that users can add to their dashboard layouts. Use this endpoint to populate the widget picker in the user interface. operationId: GetDashboardWidgetswidgetTemplates_Get parameters: - name: Version @@ -16567,7 +16567,7 @@ paths: tags: - dashboard summary: Gets the dashboard widgets. - description: Gets the dashboard widgets. + description: Submits a request to retrieve the available dashboard widget templates. Returns the same data as the GET variant. operationId: GetDashboardWidgetswidgetTemplates_Post requestBody: content: @@ -16591,7 +16591,7 @@ paths: tags: - stats summary: Stats Service - description: Stats Service + description: Returns planned change records for the specified time period in hours. Use the CountOnly, Skip, Take, Sort, and GenericFilters parameters to control pagination and filtering of results. operationId: GetCurrentPlannedChangesplannedChangeshoursPeriodHours_Get parameters: - name: CountOnly @@ -16654,7 +16654,7 @@ paths: tags: - stats summary: Stats Service - description: Stats Service + description: Submits a request to retrieve planned change records for the specified time period in hours. Use the request body to supply pagination, sorting, and filtering parameters. operationId: GetCurrentPlannedChangesplannedChangeshoursPeriodHours_Post requestBody: content: @@ -16678,7 +16678,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Returns compliance data report summaries grouped by report, starting from the specified date. Results can represent either individual device data or a group average, depending on the ReportItemId supplied.' operationId: GetComplianceDatacompliancedatastartStart_Get parameters: - name: ReportItemId @@ -16747,7 +16747,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Submits a request to retrieve compliance data report summaries starting from the specified date. Results can represent either individual device data or a group average, depending on the ReportItemId supplied in the request body.' operationId: GetComplianceDatacompliancedatastartStart_Post requestBody: content: @@ -16771,7 +16771,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Returns compliance data report summaries grouped by report, up to the specified end date. Results can represent either individual device data or a group average, depending on the ReportItemId supplied.' operationId: GetComplianceDatacompliancedataendEnd_Get parameters: - name: ReportItemId @@ -16840,7 +16840,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Submits a request to retrieve compliance data report summaries up to the specified end date. Results can represent either individual device data or a group average, depending on the ReportItemId supplied in the request body.' operationId: GetComplianceDatacompliancedataendEnd_Post requestBody: content: @@ -16864,7 +16864,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Returns compliance data report summaries grouped by report for the specified date range. Results can represent either individual device data or a group average, depending on the ReportItemId supplied.' operationId: GetComplianceDatacompliancedatastartStartendEnd_Get parameters: - name: ReportItemId @@ -16933,7 +16933,7 @@ paths: tags: - stats summary: 'Get device or group report summaries' - description: 'Get report summaries by report, for either individual devices, or as group average.' + description: 'Submits a request to retrieve compliance data report summaries for the specified date range. Results can represent either individual device data or a group average, depending on the ReportItemId supplied in the request body.' operationId: GetComplianceDatacompliancedatastartStartendEnd_Post requestBody: content: @@ -16957,7 +16957,7 @@ paths: tags: - stats summary: Invalidate group event count stats - description: Represents a request to invalidate the eventcount stats for a group for a specific set of periods. + description: Invalidates the cached event count statistics for a group for a specific set of time periods. Use this endpoint to force the hub to recalculate event count stats for the target group. operationId: InvalidateEventCountseventsinvalidate_Get parameters: - name: Version @@ -16978,7 +16978,7 @@ paths: tags: - stats summary: Invalidate group event count stats - description: Represents a request to invalidate the eventcount stats for a group for a specific set of periods. + description: Submits a request to invalidate the cached event count statistics for a group for a specific set of time periods. Supply the group and period details in the request body. operationId: InvalidateEventCountseventsinvalidate_Post requestBody: content: @@ -17000,7 +17000,7 @@ paths: tags: - testSmtpConnection summary: Tests the specified SMTP details. - description: Tests the specified SMTP details. + description: Tests the specified SMTP server connection details and returns a status indicating whether the connection was successful. Use this endpoint to validate SMTP configuration before saving. operationId: TestSmtpConnection_Get parameters: - name: Version @@ -17023,7 +17023,7 @@ paths: tags: - testSmtpConnection summary: Tests the specified SMTP details. - description: Tests the specified SMTP details. + description: Submits SMTP connection details in the request body and tests whether the server can be reached. Returns a status response indicating the result of the connection attempt. operationId: TestSmtpConnection_Post requestBody: content: @@ -17047,7 +17047,7 @@ paths: tags: - testFastConnection summary: Test Fast service connection - description: Tests the configured Fast service can be contacted. + description: Tests whether the configured Fast service endpoint can be contacted and returns a status response. Use this endpoint to verify Fast service connectivity before relying on it for operations. operationId: TestFastConnection_Get parameters: - name: Version @@ -17070,7 +17070,7 @@ paths: tags: - testFastConnection summary: Test Fast service connection - description: Tests the configured Fast service can be contacted. + description: Submits a request to test whether the configured Fast service endpoint can be contacted. Returns a status response indicating whether the connection attempt succeeded. operationId: TestFastConnection_Post requestBody: content: @@ -17094,7 +17094,7 @@ paths: tags: - testFastCustomerConnection summary: Test Fast service with credentials - description: Tests the configured Fast service can be contacted using customer credentials. + description: Tests whether the configured Fast service can be contacted using customer-specific credentials. Returns a status response indicating whether the authenticated connection attempt succeeded. operationId: TestFastCustomerConnection_Get parameters: - name: Version @@ -17117,7 +17117,7 @@ paths: tags: - testFastCustomerConnection summary: Test Fast service with credentials - description: Tests the configured Fast service can be contacted using customer credentials. + description: Submits a request to test whether the configured Fast service can be contacted using customer-specific credentials. Returns a status response indicating whether the authenticated connection attempt succeeded. operationId: TestFastCustomerConnection_Post requestBody: content: @@ -17141,7 +17141,7 @@ paths: tags: - testSyslogConnection summary: Tests the specified SysLog details. - description: Tests the specified SysLog details. + description: Tests the specified Syslog server connection details and returns a status indicating whether the connection was successful. Use this endpoint to validate Syslog configuration before saving. operationId: TestSyslogConnection_Get parameters: - name: Version @@ -17164,7 +17164,7 @@ paths: tags: - testSyslogConnection summary: Tests the specified SysLog details. - description: Tests the specified SysLog details. + description: Submits Syslog connection details in the request body and tests whether the server can be reached. Returns a status response indicating the result of the connection attempt. operationId: TestSyslogConnection_Post requestBody: content: @@ -17188,7 +17188,7 @@ paths: tags: - testServiceNowConnection summary: Tests the specified ServiceNow details. - description: Tests the specified ServiceNow details. + description: Tests the specified ServiceNow integration connection details and returns a status indicating whether the connection was successful. Use this endpoint to validate ServiceNow configuration before saving. operationId: TestServiceNowConnection_Get parameters: - name: Version @@ -17211,7 +17211,7 @@ paths: tags: - testServiceNowConnection summary: Tests the specified ServiceNow details. - description: Tests the specified ServiceNow details. + description: Submits ServiceNow integration connection details in the request body and tests whether the endpoint can be reached. Returns a status response indicating the result of the connection attempt. operationId: TestServiceNowConnection_Post requestBody: content: @@ -17235,7 +17235,7 @@ paths: tags: - testAuditorConnection summary: Tests the specified Auditor details. - description: Tests the specified Auditor details. + description: Tests the specified Auditor integration connection details and returns a status indicating whether the connection was successful. Use this endpoint to validate Auditor configuration before saving. operationId: TestAuditorConnection_Get parameters: - name: Version @@ -17258,7 +17258,7 @@ paths: tags: - testAuditorConnection summary: Tests the specified Auditor details. - description: Tests the specified Auditor details. + description: Submits Auditor integration connection details in the request body and tests whether the endpoint can be reached. Returns a status response indicating the result of the connection attempt. operationId: TestAuditorConnection_Post requestBody: content: @@ -17282,7 +17282,7 @@ paths: tags: - pipelineNodes summary: Lists pipeline node names. - description: Gets a list of pipeline node names. + description: Returns a list of all pipeline node names registered in the system. Use this endpoint to discover available pipeline nodes for configuration or routing purposes. operationId: GetPipelineNodeList_Get parameters: - name: Version @@ -17308,7 +17308,7 @@ paths: tags: - pipelineNodes summary: Lists pipeline node names. - description: Gets a list of pipeline node names. + description: Submits a request to retrieve all pipeline node names registered in the system. Returns a list of node name strings. operationId: GetPipelineNodeList_Post requestBody: content: @@ -17335,7 +17335,7 @@ paths: tags: - users summary: Add a user. - description: Add a user. + description: Creates a new user account in the system and returns the new user's details. Supply the required user properties as query parameters. operationId: AddUseradd_Get parameters: - name: Version @@ -17358,7 +17358,7 @@ paths: tags: - users summary: Add a user. - description: Add a user. + description: Creates a new user account in the system and returns the new user's details. Supply the required user properties in the request body. operationId: AddUseradd_Post requestBody: content: @@ -17382,7 +17382,7 @@ paths: tags: - users summary: Query user two-factor status - description: Represents a pre-authentication request to query the user's Two-factor authentication status. Counts as a sign-in attempt. + description: Queries the two-factor authentication (2FA) status for a user as a pre-authentication step. This call counts as a sign-in attempt, so repeated failures may trigger account lockout policies. operationId: GetUserTwoFactorStatustwoFactorStatus_Post requestBody: content: @@ -17404,7 +17404,7 @@ paths: tags: - users summary: Elevate user two-factor status - description: Represents a post-authentication request to elevate the user's Two-factor authentication status. Counts as a sign-in attempt. + description: Elevates the two-factor authentication (2FA) status for a user after they have already authenticated. This post-authentication step counts as a sign-in attempt and returns an updated authentication response on success. operationId: ElevateUserTwoFactorStatuselevateTwoFactorStatus_Post requestBody: content: @@ -17428,7 +17428,7 @@ paths: tags: - users summary: Validates a user password. - description: Validates a user password. + description: Validates the supplied password for the specified user. Returns 204 No Content on success; use this endpoint to verify password correctness without performing a full authentication. operationId: ValidateUserPasswordvalidatePassword_Get parameters: - name: Version @@ -17447,7 +17447,7 @@ paths: tags: - users summary: Validates a user password. - description: Validates a user password. + description: Submits a user password in the request body for validation. Returns 204 No Content on success, indicating the password is correct for the specified user. operationId: ValidateUserPasswordvalidatePassword_Post requestBody: content: @@ -17467,7 +17467,7 @@ paths: tags: - users summary: Delete a user. - description: Delete a user. + description: Permanently deletes the specified user account from the system. Returns 204 No Content on success. This action cannot be undone. operationId: DeleteUserdelete_Get parameters: - name: Version @@ -17488,7 +17488,7 @@ paths: tags: - users summary: Delete a user. - description: Delete a user. + description: Submits a request to permanently delete the specified user account from the system. Returns 204 No Content on success. This action cannot be undone. operationId: DeleteUserdelete_Post requestBody: content: @@ -17510,7 +17510,7 @@ paths: tags: - users summary: Get a user's details. - description: Get a user's details. + description: Returns the full details for the specified user account. Use this endpoint to retrieve profile and configuration information for a given username. operationId: GetUserUserName_Get parameters: - name: Version @@ -17533,7 +17533,7 @@ paths: tags: - users summary: Get a user's details. - description: Get a user's details. + description: Submits a request to retrieve the full details for the specified user account. Returns profile and configuration information for the given username. operationId: GetUserUserName_Post requestBody: content: @@ -17557,7 +17557,7 @@ paths: tags: - users summary: Update stored user details - description: Updates stored user details. Note that UserManage permissions are required to manage any user other than the caller. + description: Updates the stored details for the specified user account. UserManage permissions are required to modify any user account other than the caller's own. operationId: UpdateUserupdate_Get parameters: - name: Version @@ -17578,7 +17578,7 @@ paths: tags: - users summary: Update stored user details - description: Updates stored user details. Note that UserManage permissions are required to manage any user other than the caller. + description: Submits updated details for the specified user account in the request body. UserManage permissions are required to modify any user account other than the caller's own. operationId: UpdateUserupdate_Post requestBody: content: @@ -17600,7 +17600,7 @@ paths: tags: - users summary: Update user password - description: Updates stored user password. CurrentPassword property should contain the password of the user attempting to make the change. Note that UserManage permissions are required to manage any user password other than caller's. + description: Updates the stored password for the specified user. The CurrentPassword field must contain the password of the user making the request. UserManage permissions are required to change the password of any user other than the caller. operationId: UpdateUserPasswordupdatePassword_Get parameters: - name: Version @@ -17621,7 +17621,7 @@ paths: tags: - users summary: Update user password - description: Updates stored user password. CurrentPassword property should contain the password of the user attempting to make the change. Note that UserManage permissions are required to manage any user password other than caller's. + description: Submits a password update request in the request body. The CurrentPassword field must contain the password of the user making the request. UserManage permissions are required to change the password of any user other than the caller. operationId: UpdateUserPasswordupdatePassword_Post requestBody: content: @@ -17643,7 +17643,7 @@ paths: tags: - users summary: Reset user - description: Resets a user. Note that UserManage permissions are required to manage any user other than the caller. + description: Resets the specified user account to a default state. UserManage permissions are required to reset any user account other than the caller's own. operationId: ResetUserreset_Get parameters: - name: Version @@ -17664,7 +17664,7 @@ paths: tags: - users summary: Reset user - description: Resets a user. Note that UserManage permissions are required to manage any user other than the caller. + description: Submits a request to reset the specified user account to a default state. UserManage permissions are required to reset any user account other than the caller's own. operationId: ResetUserreset_Post requestBody: content: @@ -17686,7 +17686,7 @@ paths: tags: - users summary: Reset user password - description: Resets a user password. Note that this operation is intended to manage any user other than the caller. + description: Resets the password for the specified user and returns the new temporary password in the response. This operation is intended for administrators managing other users and requires UserManage permissions. operationId: ResetUserPasswordresetPassword_Get parameters: - name: Version @@ -17709,7 +17709,7 @@ paths: tags: - users summary: Reset user password - description: Resets a user password. Note that this operation is intended to manage any user other than the caller. + description: Submits a request to reset the password for the specified user and returns the new temporary password in the response. This operation is intended for administrators managing other users and requires UserManage permissions. operationId: ResetUserPasswordresetPassword_Post requestBody: content: @@ -17733,7 +17733,7 @@ paths: tags: - users summary: Generate preview reset password - description: Generates a reset password for preview without applying it. Pass the returned PreviewToken to resetPassword to apply it. + description: Generates a preview of the reset password without applying the change. Returns a PreviewToken that you can pass to the resetPassword endpoint to commit the password reset when ready. operationId: PreviewResetUserPasswordpreviewResetPassword_Post requestBody: content: @@ -17757,7 +17757,7 @@ paths: tags: - users summary: Reset user 2FA - description: Resets a user's 2FA . Note that UserManage permissions are required to manage any user other than the caller. + description: Resets the two-factor authentication (2FA) configuration for the specified user, requiring them to re-enroll. UserManage permissions are required to reset 2FA for any user other than the caller. operationId: ResetUser2fareset2fa_Get parameters: - name: Version @@ -17778,7 +17778,7 @@ paths: tags: - users summary: Reset user 2FA - description: Resets a user's 2FA . Note that UserManage permissions are required to manage any user other than the caller. + description: Submits a request to reset the two-factor authentication (2FA) configuration for the specified user. UserManage permissions are required to reset 2FA for any user other than the caller. operationId: ResetUser2fareset2fa_Post requestBody: content: @@ -17800,7 +17800,7 @@ paths: tags: - exportUserNotifications summary: Export user notifications - description: Export users and the notifications they are configured to receive + description: Exports a list of users along with the notification configurations assigned to each user. Use this endpoint to audit or back up notification settings across the system. operationId: ExportUserNotifications_Get parameters: - name: Version @@ -17823,7 +17823,7 @@ paths: tags: - exportUserNotifications summary: Export user notifications - description: Export users and the notifications they are configured to receive + description: Submits a request to export users and their configured notification settings. Returns the export data in the response body. operationId: ExportUserNotifications_Post requestBody: content: @@ -17847,7 +17847,7 @@ paths: tags: - timezones summary: List time zone names - description: Gets a list of possible time zone names. + description: Returns a list of all supported time zone names and their details. Use this endpoint to populate time zone selection options in your application. operationId: GetTimeZoneIds_Get parameters: - name: Version @@ -17873,7 +17873,7 @@ paths: tags: - timezones summary: List time zone names - description: Gets a list of possible time zone names. + description: Submits a request to retrieve all supported time zone names and their details. Returns a list of TimeZoneDetail objects. operationId: GetTimeZoneIds_Post requestBody: content: @@ -17900,7 +17900,7 @@ paths: tags: - userHasChangedPassword summary: Check if user changed password - description: Has the current user changed their password from any system assigned one? + description: Returns a boolean indicating whether the current user has changed their password from any system-assigned value. Use this endpoint to enforce first-login password change policies. operationId: UserHasChangedPassword_Get parameters: - name: Version @@ -17924,7 +17924,7 @@ paths: tags: - userHasChangedPassword summary: Check if user changed password - description: Has the current user changed their password from any system assigned one? + description: Submits a request to check whether the current user has changed their password from any system-assigned value. Returns a boolean result. operationId: UserHasChangedPassword_Post requestBody: content: @@ -17949,7 +17949,7 @@ paths: tags: - groupAlerts summary: Add group alert to user - description: Add a group alert to a user. + description: Adds a group alert notification to the specified user and returns the updated user details. Use this endpoint to configure which group change events a user receives alerts for. operationId: AddGroupAlertToUseradd_Get parameters: - name: Version @@ -17972,7 +17972,7 @@ paths: tags: - groupAlerts summary: Add group alert to user - description: Add a group alert to a user. + description: Submits a request to add a group alert notification to the specified user. Returns the updated user details on success. operationId: AddGroupAlertToUseradd_Post requestBody: content: @@ -17996,7 +17996,7 @@ paths: tags: - groupAlerts summary: Remove group notification from user - description: Remove a group notification from a user + description: Removes the specified group alert notification from a user. Provide the UserName and the alert Id to identify which notification to remove. operationId: DeleteGroupAlertFromUserdelete_Get parameters: - name: UserName @@ -18027,7 +18027,7 @@ paths: tags: - groupAlerts summary: Remove group notification from user - description: Remove a group notification from a user + description: Submits a request to remove the specified group alert notification from a user. Provide the UserName and alert Id in the request body to identify which notification to remove. operationId: DeleteGroupAlertFromUserdelete_Post requestBody: content: @@ -18049,7 +18049,7 @@ paths: tags: - groupAlerts summary: Update group notification for user - description: Update a group notification from a user + description: Updates the settings for an existing group alert notification assigned to a user. Returns 204 No Content on success. operationId: UpdateGroupAlertForUserupdate_Get parameters: - name: Version @@ -18070,7 +18070,7 @@ paths: tags: - groupAlerts summary: Update group notification for user - description: Update a group notification from a user + description: Submits updated settings for an existing group alert notification assigned to a user. Returns 204 No Content on success. operationId: UpdateGroupAlertForUserupdate_Post requestBody: content: @@ -18092,7 +18092,7 @@ paths: tags: - groupAlerts summary: Get notifications for group - description: Get the configured notifications for the specified group. + description: Returns all configured alert notifications for the specified group. Use this endpoint to review which users and notification channels are set up for a group. operationId: GetGroupAlertsForGroup_Get parameters: - name: Version @@ -18118,7 +18118,7 @@ paths: tags: - groupAlerts summary: Get notifications for group - description: Get the configured notifications for the specified group. + description: Submits a request to retrieve all configured alert notifications for the specified group. Returns a list of GroupAlert objects. operationId: GetGroupAlertsForGroup_Post requestBody: content: @@ -18145,7 +18145,7 @@ paths: tags: - users summary: Get a list of user names. - description: Get a list of user names. + description: Returns a list of all user accounts in the system, including their details. Use this endpoint to enumerate users for administrative or reporting purposes. operationId: GetUserList_Get parameters: - name: Version @@ -18171,7 +18171,7 @@ paths: tags: - users summary: Get a list of user names. - description: Get a list of user names. + description: Submits a request to retrieve all user accounts and their details. Returns a list of UserDetails objects. operationId: GetUserList_Post requestBody: content: @@ -18198,7 +18198,7 @@ paths: tags: - resetAdminPassword summary: 'Reset admin account password' - description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + description: 'Resets the admin account password and returns a new temporary password in the response. This endpoint can only be called from the local hub console and is intended for emergency account recovery.' operationId: ResetAdminPassword_Get parameters: - name: Version @@ -18219,7 +18219,7 @@ paths: tags: - resetAdminPassword summary: 'Reset admin account password' - description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + description: 'Submits a request to reset the admin account password and returns a new temporary password in the response. This endpoint can only be called from the local hub console and is intended for emergency account recovery.' operationId: ResetAdminPassword_Post requestBody: content: @@ -18241,7 +18241,7 @@ paths: tags: - resetAdminPassword summary: 'Reset admin account password' - description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + description: 'Resets the password for the specified admin account by name and returns a new temporary password in the response. This endpoint can only be called from the local hub console.' operationId: ResetAdminPasswordAdminName_Get parameters: - name: Version @@ -18262,7 +18262,7 @@ paths: tags: - resetAdminPassword summary: 'Reset admin account password' - description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + description: 'Submits a request to reset the password for the specified admin account by name. Returns a new temporary password in the response. This endpoint can only be called from the local hub console.' operationId: ResetAdminPasswordAdminName_Post requestBody: content: @@ -18284,7 +18284,7 @@ paths: tags: - resetAdminPassword summary: 'Reset admin account password' - description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + description: 'Resets the password for the specified admin account within the given organization and returns a new temporary password in the response. This endpoint can only be called from the local hub console.' operationId: ResetAdminPasswordOrganizationIdAdminName_Get parameters: - name: Version @@ -18305,7 +18305,7 @@ paths: tags: - resetAdminPassword summary: 'Reset admin account password' - description: 'Resets the admin (or named account) password, returning a new temporary password in the response. Can only be called from the local hub console.' + description: 'Submits a request to reset the password for the specified admin account within the given organization. Returns a new temporary password in the response. This endpoint can only be called from the local hub console.' operationId: ResetAdminPasswordOrganizationIdAdminName_Post requestBody: content: @@ -18327,7 +18327,7 @@ paths: tags: - userRoles summary: List user roles - description: Get a list of user roles defined in the system. + description: Returns a list of all user roles defined in the system, including built-in and custom roles. Use this endpoint to enumerate available roles for assignment or display. operationId: GetUserRoles_Get parameters: - name: Version @@ -18350,7 +18350,7 @@ paths: tags: - userRoles summary: List user roles - description: Get a list of user roles defined in the system. + description: Submits a request to retrieve all user roles defined in the system. Returns a GetUserRolesResponse containing the available roles. operationId: GetUserRoles_Post requestBody: content: @@ -18374,7 +18374,7 @@ paths: tags: - permissions summary: List permission names - description: Gets a list of permissions names defined in the system. + description: Returns a list of all permission names defined in the system. Use this endpoint to discover available permissions when creating or updating user roles. operationId: GetPermissions_Get parameters: - name: Version @@ -18400,7 +18400,7 @@ paths: tags: - permissions summary: List permission names - description: Gets a list of permissions names defined in the system. + description: Submits a request to retrieve all permission names defined in the system. Returns an array of permission name strings. operationId: GetPermissions_Post requestBody: content: @@ -18427,7 +18427,7 @@ paths: tags: - userRoles summary: Adds a custom user role - description: Adds a custom user role + description: Creates a new custom user role with the specified name, display name, permissions, and read-only flag. Returns the created role details. The Name defaults to DisplayName if not supplied. operationId: AddUserRoleadd_Get parameters: - name: Name @@ -18481,7 +18481,7 @@ paths: tags: - userRoles summary: Adds a custom user role - description: Adds a custom user role + description: Submits a request to create a new custom user role with the specified properties. Returns the created role details on success. operationId: AddUserRoleadd_Post requestBody: content: @@ -18505,7 +18505,7 @@ paths: tags: - userRoles summary: Update a user role - description: Update a user role + description: Updates the display name, external name, and associated permissions for the specified user role. Identify the role by its internal Name and supply the updated fields as query parameters. operationId: UpdateUserRoleupdate_Get parameters: - name: Name @@ -18554,7 +18554,7 @@ paths: tags: - userRoles summary: Update a user role - description: Update a user role + description: Submits updated properties for the specified user role in the request body. Returns the updated role details on success. operationId: UpdateUserRoleupdate_Post requestBody: content: @@ -18578,7 +18578,7 @@ paths: tags: - userRoles summary: Clone an existing user role. - description: Clone an existing user role. + description: Creates a copy of an existing user role with a new name, preserving all permissions from the source role. Returns the cloned role details on success. operationId: CloneUserRoleclone_Get parameters: - name: Version @@ -18601,7 +18601,7 @@ paths: tags: - userRoles summary: Clone an existing user role. - description: Clone an existing user role. + description: Submits a request to create a copy of an existing user role, preserving all permissions from the source role. Returns the cloned role details on success. operationId: CloneUserRoleclone_Post requestBody: content: @@ -18625,7 +18625,7 @@ paths: tags: - userRoles summary: Delete a user role. - description: Delete a user role. + description: Permanently deletes the user role identified by its internal name. Returns 204 No Content on success. Built-in roles cannot be deleted. operationId: DeleteUserRoledelete_Get parameters: - name: Name @@ -18652,7 +18652,7 @@ paths: tags: - userRoles summary: Delete a user role. - description: Delete a user role. + description: Submits a request to permanently delete the user role identified by its internal name. Returns 204 No Content on success. operationId: DeleteUserRoledelete_Post requestBody: content: @@ -18674,7 +18674,7 @@ paths: tags: - licenseInfo summary: Get organization license info - description: Represents a request to get an Organization's license info. + description: Returns the current license information for the organization, including license type, expiry, and entitlement details. Use this endpoint to check the active license status. operationId: GetLicenseInfo_Get parameters: - name: Version @@ -18697,7 +18697,7 @@ paths: tags: - licenseInfo summary: Get organization license info - description: Represents a request to get an Organization's license info. + description: Submits a request to retrieve the current license information for the organization. Returns a GetLicenseInfoResponse containing license type, expiry, and entitlement details. operationId: GetLicenseInfo_Post requestBody: content: @@ -18721,7 +18721,7 @@ paths: tags: - organization summary: 'Update organization license' - description: 'Represents a request to update an Organization, used to set the license.' + description: 'Updates the organization configuration, primarily used to apply a new license key. Optionally set AllowInvalidLicense to true to permit applying a license that would otherwise fail validation.' operationId: UpdateOrganizationupdate_Get parameters: - name: License @@ -18753,7 +18753,7 @@ paths: tags: - organization summary: 'Update organization license' - description: 'Represents a request to update an Organization, used to set the license.' + description: 'Submits a request to update the organization configuration, primarily used to apply a new license key. Supply the License and optional AllowInvalidLicense fields in the request body.' operationId: UpdateOrganizationupdate_Post requestBody: content: @@ -18775,7 +18775,7 @@ paths: tags: - userRolesPermisions summary: 'Check user roles and permissions' - description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + description: 'Returns a boolean indicating whether the caller, or the named user if supplied, holds the specified roles and permissions. Use this endpoint to perform authorization checks before granting access to operations.' operationId: HasRoleOrPermissioncheck_Get parameters: - name: Version @@ -18799,7 +18799,7 @@ paths: tags: - userRolesPermisions summary: 'Check user roles and permissions' - description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + description: 'Submits a request to check whether the caller, or the named user if supplied, holds the specified roles and permissions. Returns a boolean result.' operationId: HasRoleOrPermissioncheck_Post requestBody: content: @@ -18824,7 +18824,7 @@ paths: tags: - userRolesPermissions summary: 'Check user roles and permissions' - description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + description: 'Returns a boolean indicating whether the caller, or the named user if supplied, holds the specified roles and permissions. Use this endpoint to perform authorization checks before granting access to operations.' operationId: HasRoleOrPermissioncheck2_Get parameters: - name: Version @@ -18848,7 +18848,7 @@ paths: tags: - userRolesPermissions summary: 'Check user roles and permissions' - description: 'Checks whether the caller, or the named user if supplied, has the specified roles and permissions.' + description: 'Submits a request to check whether the caller, or the named user if supplied, holds the specified roles and permissions. Returns a boolean result.' operationId: HasRoleOrPermissioncheck2_Post requestBody: content: @@ -18873,7 +18873,7 @@ paths: tags: - userRolesPermisions summary: 'Get user roles and permissions' - description: 'Gets roles and permissions for the caller, or the named user if supplied.' + description: 'Returns the full set of roles and permissions for the caller, or for the named user if supplied. Use this endpoint to retrieve authorization context for display or downstream access decisions.' operationId: GetRolesAndPermissions_Get parameters: - name: Version @@ -18896,7 +18896,7 @@ paths: tags: - userRolesPermisions summary: 'Get user roles and permissions' - description: 'Gets roles and permissions for the caller, or the named user if supplied.' + description: 'Submits a request to retrieve the full set of roles and permissions for the caller, or the named user if supplied. Returns a GetRolesAndPermissionsResponse object.' operationId: GetRolesAndPermissions_Post requestBody: content: @@ -18920,7 +18920,7 @@ paths: tags: - userRolesPermissions summary: 'Get user roles and permissions' - description: 'Gets roles and permissions for the caller, or the named user if supplied.' + description: 'Returns the full set of roles and permissions for the caller, or for the named user if supplied. Use this endpoint to retrieve authorization context for display or downstream access decisions.' operationId: GetRolesAndPermissions2_Get parameters: - name: Version @@ -18943,7 +18943,7 @@ paths: tags: - userRolesPermissions summary: 'Get user roles and permissions' - description: 'Gets roles and permissions for the caller, or the named user if supplied.' + description: 'Submits a request to retrieve the full set of roles and permissions for the caller, or the named user if supplied. Returns a GetRolesAndPermissionsResponse object.' operationId: GetRolesAndPermissions2_Post requestBody: content: @@ -18967,7 +18967,7 @@ paths: tags: - auth summary: Sign In - description: Sign In + description: Authenticates a user against the specified identity provider and returns an authentication response including a bearer token. Supply credentials such as UserName and Password, or an AccessToken for OAuth-based providers. operationId: Authenticateprovider_Get parameters: - name: provider @@ -19018,7 +19018,7 @@ paths: tags: - auth summary: Sign In - description: Sign In + description: Submits authentication credentials to the specified identity provider and returns an authentication response including a bearer token. Supports username/password and OAuth token-based authentication. operationId: Authenticateprovider_Post parameters: - name: provider @@ -19078,7 +19078,7 @@ paths: tags: - auth summary: Sign In - description: Sign In + description: Authenticates a user using the default or specified identity provider and returns an authentication response including a bearer token. Supply credentials as query parameters, including provider, UserName, Password, or OAuth tokens as appropriate. operationId: Authenticate_Get parameters: - name: provider @@ -19128,7 +19128,7 @@ paths: tags: - auth summary: Sign In - description: Sign In + description: Submits authentication credentials via query parameters and request body to authenticate a user. Returns an authentication response including a bearer token on success. operationId: Authenticate_Post parameters: - name: provider