The following use cases are drawn from actual customer usage of the Armis API and highlight the sheer flexibility of our API. Developers are tackling a massive range of problems, writing custom connectors for everything from enterprise ITSM and unified communications platforms to highly specialized systems for digital kiosks, industrial OT controllers, and core data center infrastructure.

Think of these examples as a starting point. They demonstrate how you can leverage the API to extend the Armis platform, automate complex workflows, and solve unique problems that go far beyond our standard features. Let's dive in and see what's possible.

1. Data Enrichment & Context

This category addresses how to integrate your proprietary data with Armis, and how to extract and enrich contextual information for analysis and reporting.

Core Function	Example Scenario
Adaptive Context Mapping	Instead of hardcoding field names, use the API to automatically discover all searchable metadata, including standard fields, custom properties, and integration-unique fields. This ensures your reporting remain accurate even as your environment and integrations evolve.
Workflow Asset Tagging	A repair management vendor leverages Custom Properties to programmatically classify devices into operational states (e.g., "In Repair"). This provides immediate, real-time status insights for every asset across the enterprise landscape.
Specialized Asset Enrichment	A global retail chain uses the API to pull unique data (e.g., software versions, last reboot times) from specialized kiosk management consoles to populate custom fields in Armis, centralizing data that typically lives in silos.
Large-Scale Data Retrieval	A major airline data team utilizes the API to export hundreds of thousands of device records. By leveraging pagination and optimized search queries, they handle massive datasets for long-term storage and trend analysis.
Data Synchronization	Programmatically pull normalized intelligence on Applications, Risk Factors, and Vulnerabilities into your SIEM or BI platform. This ensures all stakeholders are working from the same "definitive source of truth."
Device Retrieval	Programmatically retrieve key device data (like `device_id` and `display`) by filtering for specific identifiers (MAC, Serial Number) or by activity windows (e.g., assets seen within the last 24 hours).
Source Attribution & Auditing	A security analyst audits data quality by identifying exactly which source (e.g., `Smart Active Querying` vs. a third-party integration) reported a specific property. Filtering by `data_source` ensures the integrity of your asset intelligence.

2. Operational Management & Control

This category focuses on programmatic control over your organizational structure and infrastructure across Armis Centrix™.

Core Function	Example Scenario
Infrastructure Synchronization	A large university hospital needed to programmatically align Armis with their IPAM/DCIM source-of-truth. They wrote a script to replicate their exact physical and logical site hierarchy, ensuring structural context is always accurate for segmentation needs.
Hierarchy Setup	As a global organization with offices worldwide, you can automate the creation of distinct Sites in Armis (e.g., San Francisco, London), ensuring each corresponds to a physical location for a clear, contextual view of assets.

3. Infrastructure Deployment

This category focuses on automating the setup and scaling of the Armis platform itself, enabling rapid visibility across global environments.

Core Function	Example Scenario
Automated Collector Deployment	A large enterprise with multiple data centers needed to deploy Armis collectors at scale. Instead of manual setup, they used the API to programmatically retrieve secure, pre-signed download URLs and unique image credentials for various platforms (OVA, VHDX, RPM). This enabled them to incorporate collector deployment directly into their CI/CD and infrastructure-as-code workflows for seamless, multi-site expansion.

Core Function

Example Scenario

Automated Collector Deployment

A large enterprise with multiple data centers needed to deploy Armis collectors at scale. Instead of manual setup, they used the API to programmatically retrieve secure, pre-signed download URLs and unique image credentials for various platforms (OVA, VHDX, RPM). This enabled them to incorporate collector deployment directly into their CI/CD and infrastructure-as-code workflows for seamless, multi-site expansion.

Our Roadmap: Continuous Improvement

The Armis Developer Portal evolves based on your needs. We continuously add new use cases, guides, and API endpoints driven by community feedback and business demand.

Don't see your use case here? Share it in the Community Discussions — your input shapes our roadmap.