Tag API

The Tag API is a unified device tagging solution for all Knox cloud services. It enables you to assign and manage common tags, which are cross-service device labels that let you filter and organize devices more efficiently across your organization.

Audience

This guide is primarily intended for the following audiences:

• Enterprise customers who need to categorize and manage devices across multiple Knox cloud services.
• Managed Service Providers (MSPs) who need to provide tagging capabilities across Knox cloud services to their customers.
• UEM partners who need to integrate tagging capabilities across Knox cloud services for their enterprise platforms.

Typically, enterprise customers and MSPs integrate using 2-legged authentication, while UEM partners use 3-legged authentication.

Difference between common tags and service tags

Common tags are different from service tags, which are specific to a single Knox cloud service such as Knox Mobile Enrollment or Knox Configure, and can’t be used to filter devices across services.

Common tags and service tags don’t appear in the same list in Knox Admin Portal.

• Common tags can be managed from the COMMON TAGS tab on the common Devices page.
• Service tags can be managed from service-specific Devices pages, such as for Knox Manage.

Additional differences are listed in the following table.

Key capabilities

The Tag API enables you to:

• Create, update, and delete tags: Manage the common tag lifecycle for your organization.
• Bulk-assign tags: Assign common tags to multiple devices in a single request.
• Bulk-unassign tags: Remove common tags from multiple devices in a single request.
• Find tagged devices: Retrieve and filter common tags, with pagination options for the result set.

Use cases

The Tag API is primarily designed for the following scenarios:

• Enterprise device organization: Categorize devices by department, location, or function for streamlined management
• Automated device provisioning: Integrate tagging into device enrollment workflows
• Bulk device management: Apply organizational tags to large device fleets efficiently

Where to start

Related resources

• Knox OAuth 2.0 Authentication
• Scopes for Knox cloud services APIs