Webhooks
Signed payloads for enrollment, alert, and command events, with automatic delivery retries.
Explore →Resources/API Reference
Build on the same API we run.
The full Hive control plane, available as a REST API: devices, groups, policies, apps, commands, and alerts. Authenticate with scoped API keys, wire up webhooks, and ship against the same endpoints our own console uses.
Overview
One API, the whole console
Every action available in the Hive console is also a documented API call: enrolling a device, pushing a policy, queuing a command.
01
REST API
A predictable, resource-oriented API served over HTTPS, returning JSON, and versioned so your integration never breaks under you.
- Base URL: api.hivemdm.com/v1, JSON in and out
- Idempotency keys on every write to make retries safe
- Cursor-based pagination on every list endpoint
- A sandbox environment for testing before you ship
02
Authentication
Organisation-scoped API keys for server-to-server calls, and short-lived scoped tokens when you need to delegate narrower access.
- API keys generated and revoked from the console
- Scoped tokens limited to a resource, group, or action
- Per-key rate limits, usage metrics, and audit logging
- Zero-downtime key rotation with an overlap window
Core resources
Six resources, one consistent shape
Every endpoint follows the same request and response shape, so learning one resource means you already know the rest.
| Resource | Description | Key operations |
|---|---|---|
| Devices | Enrollment state, hardware detail, and live health | list, get, command, delete |
| Groups | Static and dynamic device groupings | list, create, update, delete |
| Policies | Configuration profiles and inheritance | list, get, assign, publish |
| Apps | Managed Play, private, and APK packages | list, upload, assign, rollback |
| Commands | Remote actions queued to a device | create, get, cancel |
| Alerts | Alert rules and triggered incident history | list, get, acknowledge |
Extend it
Webhooks, SDKs, and starters
Push events out with webhooks, or build directly against the platform with an SDK for the layer you're integrating.
Android Agent SDK
Embed the Hive agent directly into an OEM image or a custom AOSP build.
Explore →OEM SDK
Platform-signed hooks for manufacturers shipping fleet-ready hardware.
Explore →Peripheral SDK
Wire scanners, printers, and payment devices into fleet-wide health monitoring.
Explore →Example projects
Zero-touch provisioning script
A starter that wires enrollment into your own device-procurement pipeline.
View guide →Kiosk health dashboard
A reference build polling device state to drive an ops-room display.
View guide →Alert-to-Slack relay
Forward monitoring alerts into a channel your team already watches.
View guide →Rate limits & versioning
Stable now, documented as it changes
v1 is the current stable surface. Every change, whether a new endpoint, a new field, or a deprecation, ships to the changelog before it ships to production.
- Default rate limit per API key
- 1K/minDefault rate limit per key
- Core API resources
- 6Core API resources
- API uptime, past 30 days
- 100%API uptime, past 30 days
- Current stable version
- v1Current stable version
Related