Actions22
- Account Actions
- Automation Actions
- Device Actions
- Label Actions
- Mass Action Actions
- User Actions
- Zone Actions
Label → Create Label
AI-generatedSummary
Create a new label in the Prey system and assign specified devices to that label.
Inputs
- API Key Permission — Choose read-only or read & write permission level matching the API key credentials; write is needed for this operation.
- Label Name (required) — Specify the name of the new label to create.
- Device Names or IDs — Select one or more devices by name or ID to assign to this label; supports selection from a list or specifying IDs via an expression.
- Request Options — Optional settings including batching parameters, SSL certificate validation override, proxy configuration, and request timeout.
Output shape
An object representing the created label, including its assigned devices.
The request sends a POST to /labels with the label name and assigned devices in the body. The response contains the created label data. The operation requires an API key with write permission.