Create a reporting group
POST/v1/organizations/:organization_id/reporting-groups
Creates a new reporting group for the specified organization. Reporting groups are used for organizing and managing device configurations, product settings, and patch policies. You can 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 ID of the successfully created reporting group.
Request
Responses
- 201
- 400
- 401
- 404
- 422
- 429
- 500
Reporting group created successfully. The response contains the created resource.
Invalid request. Common causes: - Mandatory fields are missing (name, product_config_id) - Invalid field values - Invalid ID format for fields product_config_id, patch_policy_target_id, or intermediate_device_*_id - Invalid fishing_pattern_field value (must be one of: full_name, description, ou, current_subnet) - Fishing_pattern value too long (exceeds maxLength: 250) - 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
Organization not found
Unprocessable entity. Common causes: - Product configuration not found or does not belong to the organization - Intermediate device Workspace IDs do not exist or do not belong to the organization
Too Many Requests
Internal Server Error