Skip to content

Two Way PSA and REST API

Tyler Hatfield edited this page Nov 6, 2026 · 2 revisions

Two-Way PSA Synchronization & REST API Reference

Vitrine RMM provides bidirectional integration with ITFlow and an extensible REST & WebSocket API.


1. Bidirectional PSA Ticket Synchronization

  • Ticket Lifecycle (GET, POST, PUT /api/psa/tickets): Create service tickets from Vitrine, automatically open high-priority tickets when self-healing circuit breakers trip, and resolve/reopen tickets bidirectionally with ITFlow.
  • Webhook Ingestion (POST /api/psa/webhook): Receives external ticket status updates and synchronizes resolution states.

2. Core REST & WebSocket API Endpoints

  • Fleet & Smart Groups:
    • GET /api/devices — List managed endpoints with effective status and warranty metadata.
    • GET /api/smart-groups, POST /api/smart-groups, DELETE /api/smart-groups/:id — Manage dynamic Smart Groups.
    • GET /api/devices/:id/notes, POST /api/devices/:id/notes, DELETE /api/devices/:id/notes/:noteId — Manage pinned technician runbook notes.
  • Power, WoL & Intel vPro/AMT:
    • POST /api/devices/:id/wol — Trigger Tiered Wake-on-LAN via subnet peer relays.
    • POST /api/devices/:id/enable-wol — Remotely configure OS NIC & OEM WMI BIOS Wake-on-LAN.
    • POST /api/devices/:id/amt-provision — Provision Intel vPro/AMT CIRA with node deduplication.
  • Security, LAPS & Guest Portal:
    • POST /api/auth/verify-mfa — Verify RFC 6238 TOTP Step-Up MFA code.
    • GET /api/devices/:id/laps?reveal=true & POST /api/devices/:id/laps/rotate — Reveal or rotate LAPS credentials.
    • GET /api/guest-grants, POST /api/guest-grants, DELETE /api/guest-grants/:id, POST /api/guest-portal/:id/auth — Scoped vendor portal management.
  • Tokenized Agent Deployment:
    • POST /api/installers/generate — Issue tokenized installer link & one-liner command.
    • GET /api/agent/deploy & GET /api/agent/download — Serve Authenticode-signed deployment scripts.
  • WebSockets:
    • /ws/telemetry — Real-time CPU, RAM, and Network Mbps stream.
    • /ws/terminal — Interactive background shell execution.

3. Executive QBR & Fleet Health Report Generator

The Executive QBR view calculates composite Fleet Health Index scores, BitLocker & EDR compliance percentages, and self-healing hours saved, with one-click print/PDF export for client stakeholders.

Clone this wiki locally