Update a reporting group
PUT/v1/organizations/:organization_id/reporting-groups/:reporting_group_id
Updates the configuration of an existing reporting group, including name, description, patch policy target, search pattern, and intermediate devices. This endpoint implements full replacement semantics: all updateable fields must be included in the request. Omitting optional fields will clear them (idempotent behavior). Optionally configure intermediate devices (up to 3) by providing Workspace identifiers. Intermediate devices are used for actions like Wake-on-LAN in secure networks, allowing remote powering on of devices through intermediate gateways. Intermediate devices must be defined sequentially: you cannot define intermediate_device_2_id without intermediate_device_1_id, nor intermediate_device_3_id without intermediate_device_2_id. All intermediate device Workspace IDs must exist and belong to the organization. Returns the updated resource (200) after a successful update.
Request
Responses
- 200
- 400
- 401
- 404
- 422
- 429
- 500
Reporting group updated successfully. The response contains the updated resource.
Invalid request. Common causes: - Mandatory fields are missing (name) - Invalid field values - Invalid fishing_pattern_field value (must be one of: full_name, description, ou, current_subnet) - Fishing_pattern value too long (exceeds maxLength: 250) - Invalid ID format for patch_policy_target_id or intermediate_device_*_id fields - Intermediate devices not defined sequentially (intermediate_device_2_id requires intermediate_device_1_id, intermediate_device_3_id requires intermediate_device_2_id)
Unauthorized - authentication required
Not found. Common causes: - Report group not found or does not belong to the organization - Patch policy target not found
Unprocessable entity. Common causes: - Intermediate device Workspace IDs do not exist or do not belong to the organization
Too Many Requests
Internal Server Error