Augmentt

Overview

Augmentt is an M365 SaaS security & management platform for MSPs (the Discover / Secure / Engage product family). Its public API exposes the data behind the portal's reports — the customer roster, the Secure report family (MFA, Security Posture, Threat, Summary), the Microsoft License report, and Augmentt product-license consumption.

The Augmentt API is read-only, so Bumblebee can query customers and reports but cannot create or modify anything in your Augmentt tenant. This integration is currently a research preview: it was built from Augmentt's published API documentation, and Augmentt issues API keys through its support team rather than a self-serve portal screen.

Prerequisites & Setup

Before setting up the Augmentt integration, you need:

• An Augmentt tenant on a plan with API access (available to partners using Autopilot)
• An AccessKeyId and AccessKeySecret pair issued by the Augmentt team

Request your API keys

Augmentt has no key-generation screen in the portal — keys are provisioned by their team:

1. Open the Augmentt support portal (or contact your account manager)
2. Submit a request for Augmentt API access, mentioning you need an AccessKeyId / AccessKeySecret pair for api.augmentt.com
3. The Augmentt team delivers the two values to you securely — store both in your password manager

Vendor documentation:

• API guide: support.augmentt.com — Augmentt API

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select Augmentt
3. Paste your Access Key ID and Access Key Secret
4. Save the configuration
5. Run a test request (e.g. list customers) from the validation card

API Limits

Augmentt does not publish rate limits or pagination for the API — reports return complete datasets in one response. The per-company MFA and Threat reports can be large; Bumblebee's tools accept a response_filter projection so the agent can request just the fields it needs.

Available Tools

Customers (2 tools)

• list_customers — List the companies/tenants configured in Augmentt (Configuration → Companies); each record's id is the customerId the report tools need. Optional: customer_id (int, fetch a single customer).
• list_customer_licenses — Augmentt product-license consumption per customer (Management → License Center): M365 tenant ID, PSA tenant ID, and Secure / Engage / Discover usage. Optional: customer_id (int).

Reports (5 tools)

• get_mfa_report — MFA report (Secure → MFA Report): authentication methods, MFA configuration and status counts, plus a per-employee breakdown. Optional: customer_id (int — omit for the All Companies rollup).
• get_posture_report — Security Posture report (Secure → Security Posture): posture recommendations, configuration status, and security checks. Optional: customer_id (int — omit for the All Companies rollup).
• get_license_report — Microsoft License report: license types, trends, upcoming renewals, overview, and per-user assignments. Optional: customer_id (int — omit for the All Companies rollup).
• get_summary_report — Summary report (Secure → Summary Report): prevented incidents, Microsoft Identity/Security scores, MFA status, and prevented risky sign-ins. Required: customer_id (int).
• get_threat_report — Threat report (Secure → Threat Report): risk detections with trends and geolocation, top risk types, and at-risk accounts. Required: customer_id (int).

Example requests

# Which of my customers still have unprotected admin accounts?
get_mfa_report(customer_id=123)

# Microsoft license renewals coming up across all companies
get_license_report()

# Threat posture for one customer, trimmed to the headline numbers
get_threat_report(
    customer_id=123,
    response_filter="riskDetections.{highRisk: highRisk, mediumRisk: mediumRisk, top5Types: top5Types}",
)