Datto SaaS Protection Seat Coverage
Overview
The two questions an MSP asks of SaaS Protection every week are "is everyone who should be protected actually protected?" and "are the backups for protected seats succeeding?". Both are answered from read tools; only the remediation step writes.
Anti-triggers
- Auth, tool list, error codes — use
datto-saas-protection-api-patterns.
- Restoring data — there is no restore tool. Restores are started in the SaaS Protection portal.
Workflow: coverage sweep
datto_saas_list_domains — every customer, with saasCustomerId, externalSubscriptionId and seatsUsed. Use search to narrow to one customer.
- For each customer,
datto_saas_list_seats with seatState: "Unprotected", then again with seatState: "Paused".
- Group the results by
seatType (User, SharedMailbox, SharedDrive, Site, TeamSite, Team). Unprotected User seats are usually the finding that matters; unprotected Site or Team seats are often deliberate.
- Report per customer: protected count, unprotected count by type, paused count. Flag paused seats separately: they keep old backups but take no new ones.
If a seat read fails, retry it once. If it still fails, mark that customer's result as incomplete and say which read failed; never present a partial sweep as complete.
To inspect one person, call datto_saas_get_seat with seatId set to their email (the mainId) or remoteId, plus saasCustomerId (pick the customer if prompted). It returns the seat card:
{ "saasCustomerId": 123456, "seatId": "jane.doe@contoso.example" }
Workflow: backup health
datto_saas_list_applications for the customer (daysUntil: 7 for a weekly review) — backup status per suite (Exchange, OneDrive, SharePoint, Teams, Gmail, Drive) per window.
datto_saas_get_backup_stats for the same customer — per-service last-7-day status, last backup times and storage.
- A suite whose recent windows are failing, or whose last backup is older than a day, is the finding. Name the suite and the last good backup time.
- If
datto_saas_list_applications or datto_saas_get_backup_stats fails for a customer, retry once, then mark that customer's backup health as unknown in the report rather than leaving it out.
Remediation: licensing seats
Licensing a seat starts protection and billing, so it is always a proposal first:
- Build the exact list: customer,
externalSubscriptionId, one seatType, the remoteId values (at most 100 per call), and the action (License, Pause or Unlicense).
- Show it to the user and state the billing effect.
- Only after explicit approval, call
datto_saas_bulk_seat_change. The server asks for confirmation itself; on clients that cannot prompt, pass confirm: true only for the change the user approved.
Never chain a sweep straight into a bulk change, and never Unlicense a seat to "clean up" without the user naming it: unlicensed seats stop being protected.
Gotchas
- One seat type per bulk call. Licensing users and shared mailboxes for the same customer takes two calls.
Unprotected includes leavers. A disabled account that still exists in the tenant shows as unprotected. Check with the customer before licensing it.
- Spanning overlap. If the customer also uses Spanning for the same workload, an unprotected seat here may be protected there.
1---2name: datto-saas-protection-seat-coverage3description: >4 Seat-coverage and backup-health sweep for Datto SaaS Protection: finding5 unprotected and paused seats per customer, reading per-application backup6 status and detailed stats, and proposing (never silently applying) seat7 licence changes with datto_saas_bulk_seat_change.8when_to_use: >-9 When checking which Microsoft 365 or Google Workspace users are actually backed up, or whether10 SaaS backups are failing. Use when: saas backup coverage, unprotected seats, paused seats,11 backupify health, m365 backup failing, seat audit, or license new users for backup.12metadata:13 source: https://skillmd.com/skills/wyre-ai/datto-saas-protection-seat-coverage14---1516# Datto SaaS Protection Seat Coverage1718## Overview1920The two questions an MSP asks of SaaS Protection every week are "is everyone who should be protected actually protected?" and "are the backups for protected seats succeeding?". Both are answered from read tools; only the remediation step writes.2122## Anti-triggers2324- **Auth, tool list, error codes** — use `datto-saas-protection-api-patterns`.25- **Restoring data** — there is no restore tool. Restores are started in the SaaS Protection portal.2627## Workflow: coverage sweep28291. `datto_saas_list_domains` — every customer, with `saasCustomerId`, `externalSubscriptionId` and `seatsUsed`. Use `search` to narrow to one customer.302. For each customer, `datto_saas_list_seats` with `seatState: "Unprotected"`, then again with `seatState: "Paused"`.313. Group the results by `seatType` (`User`, `SharedMailbox`, `SharedDrive`, `Site`, `TeamSite`, `Team`). Unprotected `User` seats are usually the finding that matters; unprotected `Site` or `Team` seats are often deliberate.324. Report per customer: protected count, unprotected count by type, paused count. Flag paused seats separately: they keep old backups but take no new ones.3334If a seat read fails, retry it once. If it still fails, mark that customer's result as incomplete and say which read failed; never present a partial sweep as complete.3536To inspect one person, call `datto_saas_get_seat` with `seatId` set to their email (the `mainId`) or `remoteId`, plus `saasCustomerId` (pick the customer if prompted). It returns the seat card:3738```json39{ "saasCustomerId": 123456, "seatId": "jane.doe@contoso.example" }40```4142## Workflow: backup health43441. `datto_saas_list_applications` for the customer (`daysUntil: 7` for a weekly review) — backup status per suite (Exchange, OneDrive, SharePoint, Teams, Gmail, Drive) per window.452. `datto_saas_get_backup_stats` for the same customer — per-service last-7-day status, last backup times and storage.463. A suite whose recent windows are failing, or whose last backup is older than a day, is the finding. Name the suite and the last good backup time.474. If `datto_saas_list_applications` or `datto_saas_get_backup_stats` fails for a customer, retry once, then mark that customer's backup health as unknown in the report rather than leaving it out.4849## Remediation: licensing seats5051Licensing a seat starts protection **and billing**, so it is always a proposal first:52531. Build the exact list: customer, `externalSubscriptionId`, one `seatType`, the `remoteId` values (at most 100 per call), and the action (`License`, `Pause` or `Unlicense`).542. Show it to the user and state the billing effect.553. Only after explicit approval, call `datto_saas_bulk_seat_change`. The server asks for confirmation itself; on clients that cannot prompt, pass `confirm: true` only for the change the user approved.5657Never chain a sweep straight into a bulk change, and never `Unlicense` a seat to "clean up" without the user naming it: unlicensed seats stop being protected.5859## Gotchas6061- **One seat type per bulk call.** Licensing users and shared mailboxes for the same customer takes two calls.62- **`Unprotected` includes leavers.** A disabled account that still exists in the tenant shows as unprotected. Check with the customer before licensing it.63- **Spanning overlap.** If the customer also uses Spanning for the same workload, an unprotected seat here may be protected there.