CIPP icon

CIPP

CIPP-API is an Azure Function App providing the logic layer for the CIPP platform. This spec is auto-generated via static analysis of both the API (PowerShell) and frontend (React/Next.js) repositories. Last generated: 2026-03-02.

Actions75

EndpointAutopilot → ExecSetAPDeviceGroupTag

AI-generated

Overview

This node interacts with the CIPP API to manage Endpoint Autopilot devices, specifically to set a group tag on an Autopilot device. It is useful for IT administrators who need to organize or categorize Autopilot devices within a tenant by assigning group tags. For example, an admin can tag devices by department or location to streamline device management and reporting.

Use Case Examples

  1. Assign a group tag to a specific Autopilot device by providing the tenant filter, device ID, group tag, and optionally the serial number.
  2. Update the group tag for multiple devices in batches to avoid rate limiting.

Properties

Name Meaning
Tenant Filter The tenant filter to specify the target tenant domain for the operation.
Device Id The unique identifier of the Autopilot device to set the group tag for.
Group Tag The group tag to assign to the Autopilot device.
Serial Number The serial number of the Autopilot device (optional). Used for additional identification.

Output

JSON

  • debug - Debug information including actual URL, query parameters, headers, and body sent for each API request (if debug option is enabled).
  • * - The JSON response from the API call, structure varies depending on the API response.

Dependencies

  • CIPP API with appropriate API key credential

Troubleshooting

  • Ensure the tenant filter is correctly specified to target the right tenant domain.
  • Verify that the device ID and group tag are valid and exist in the Autopilot system.
  • If the API request fails, check the debug output for the actual request details to diagnose issues.
  • Handle rate limiting by using batching options to control request frequency and batch size.

Discussion