Skip to main content
Connector guides

Connect Slide

Slide is a backup, continuity, and disaster-recovery (BCDR) platform for MSPs — backup appliances ("Slides"), the agents they protect, snapshots, and the recovery workflows (file restores, image…

Written By Christopher Scaminaci

Last updated 6 days ago

Slide is a backup, continuity, and disaster-recovery (BCDR) platform for MSPs — backup appliances ("Slides"), the agents they protect, snapshots, and the recovery workflows (file restores, image exports, and bootable recovery virtual machines) built on top of them. StackJack talks to Slide through the Slide public API.

Connecting Slide to StackJack gives your AI assistant a broad family of slide_ MCP tools — MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

  • Inventory clients, devices (appliances), agents, snapshots, and backups across your fleet
  • Investigate alerts and the audit log — who did what, and what needs attention
  • Recover (on Pro plans) — start backups, mount file restores and push files back, export disk images, and boot recovery virtual machines
  • Manage (on Pro plans) recovery networks, including IPsec tunnels, port forwards, and WireGuard peers, plus device VLANs and power state

How StackJack authenticates to Slide

Slide uses a single user-based API token. You create and manage it in the Slide Console, and StackJack sends it on every request as an Authorization: Bearer credential. There is no client ID, sign-in redirect, or refresh-token flow. Slide's current public documentation does not publish a fixed expiration or guaranteed lifetime for API tokens, so monitor the connection and replace the token if Slide invalidates or revokes it.

The token inherits the permissions of the Slide account it belongs to — everything your AI can see or change in Slide is bounded by what that account can. A 403 from a tool means the account lacks that permission, not a StackJack-side block.

Slide is a global service with one address (https://api.slide.tech) — there are no regional endpoints, so there is no region to choose.

Before you begin

  • In StackJack: you need a role that can manage connectors (tenant Owner, a co-owner, or an Administrator).
  • In Slide: you need a Slide user that can create an API token and has only the role/permissions StackJack should inherit. For organization-wide automation, prefer a dedicated integration user over a personal administrator.

Step 1 — Create an API token in the Slide Console

  1. Sign in to the Slide Console and go to Settings → API.
  2. Create a new API token. Slide's public docs do not promise a fixed expiration; manage and revoke tokens from this page.
  3. Copy the token immediately and store it securely — treat it like a password. Anyone with the token can read and act on your Slide account.

Step 2 — Add the credential in StackJack

  1. In the StackJack portal, open Connectors.
  2. Select the Slide card. Choose How To Connect for the inline checklist or Configure to enter the token.
  3. Paste your API token. There is no client ID or URL to enter — the address is fixed.
  4. Click Save.

What happens when you save

  • The token is stored encrypted in Azure Key Vault — never in the StackJack database, and never shown back to you.
  • If this is the first time you configure Slide, a Free-tier subscription for the connector is created automatically so its Free tools work right away.
  • StackJack validates without changing Slide data by calling GET /v1/device?limit=1.
  • A successful probe shows Connected. A failed probe preserves the credential and shows Needs Attention with Slide's error and a Re-test action.

Pagination

Slide list tools use offset and limit. The API defaults to 10 items and caps a page at 50; StackJack clamps out-of-range limits to a valid value. Read the response's pagination.next_offset and pass that value as the next call's offset. If next_offset is absent, the list is complete.

Do not calculate the next page from a total count. Slide removed pagination.total from resource-list responses in API v1.19.6; next_offset is the supported continuation signal.

Plans and available tools

  • Free includes reads across accounts, users, clients, alerts, the audit log, agents (including file search), devices and their networks and VLANs, backups, snapshots, file restores, image exports, recovery virtual machines, and networks.
  • Pro adds account/alert settings updates, client and agent lifecycle actions, device power and network/VLAN changes, and recovery actions — start a backup, create and push file restores, export images, boot and delete recovery VMs, and manage recovery networks (IPsec / port-forward / WireGuard).
  • Business offers the same tool set as Pro with a higher monthly call quota.

See the generated Slide tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.

Slide has no per-user sign-in for the API (the token is a single account credential), so all AI traffic authenticates as that one token — there is no per-user attribution. Current pricing and quotas are shown in the portal's Billing page and at checkout.

A note on recovery actions. Several Pro tools change live infrastructure — pairing an agent, powering a device off or rebooting it, starting a backup, pushing recovered files onto a protected system, exporting an image, or booting a recovery virtual machine. Deleting clients, passphrases, VLANs, restores, exports, recovery VMs, networks, and network rules can remove working recovery configuration. StackJack marks these operations destructive or sensitive. Whether your AI application asks you to confirm before running one depends on that application's own settings — see Destructive tools and confirmation. Review those settings, and scope access with the MCP Setup tool selections and the Permissions page.

Power-off has no remote undo. Powering off a Slide appliance stops backups and restores, and the API has no matching remote power-on operation. Confirm someone can physically restore power before approving that tool.

Eventual consistency. Slide is eventually consistent: a resource you just created or changed may take a moment to become readable. Your AI shouldn't assume a write is visible on the very next read — a brief "not found" right after a create usually resolves on a retry a moment later.

Rate limits

Slide gives each API token a pool of 50 requests, refilled at 10 requests per second. Exceeding it returns HTTP 429 with err_rate_limit_exceeded; Slide recommends waiting and using exponential backoff. StackJack adds an aggregate pace of 500 requests per minute and records a short backoff when Slide returns 429. Large or parallel fleet reads can still exhaust the burst pool, so reduce concurrency rather than immediately replaying the same burst.

Rotating or replacing the token

The API token is the recovery secret. If you revoke the token in the Slide Console — or it is otherwise invalidated — the stored credential stops working. To restore access, mint a new token in Settings → API, then open Connectors → Slide → Configure in StackJack, paste the new token, and Save.

Disconnecting Slide

Use Disconnect in the Slide drawer to remove StackJack's stored token and stop future Slide API calls. Disconnecting does not revoke the token in Slide and does not undo backups, restores, exports, virtual machines, network changes, or device actions already started. Revoke the token separately in Slide Console → Settings → API if it should no longer work anywhere.

For a Free subscription, the confirmation can also remove Slide tools from tool lists. A paid connector plan remains separate billing state; use Manage on Billing on the connector card if you also want to end it — it opens this connector's removal dialog on the Billing page. A legacy website subscription reads Cancel Plan instead.

Troubleshooting

SymptomLikely causeWhat to do
Needs Attention appears right after savingThe token was mis-pasted, revoked, or cannot list devicesConfirm the token and its user permissions in Settings → API, update it in StackJack, then choose Re-test
Tools worked, then started failing with an auth errorThe token was revoked or regenerated in SlideMint a new token and update the credential in Connectors → Slide → Configure
One tool returns a 403 while others succeedThe token's Slide account lacks the permission that tool needsGrant that permission to the account in Slide, or use a token from an account that has it
A resource you just created returns "not found"Slide is eventually consistent — the write isn't readable yetRetry the read after a moment; it should resolve on its own
A list repeats or skips itemsThe next offset was calculated manually or a stale offset was reusedUse the immediately prior response's pagination.next_offset; absence means the list is complete
Power-off completed and the device is unreachablePower-off stops the appliance and Slide exposes no remote power-on APIRestore power physically/on-site; confirm that path before approving future power-offs
Write or action tools missing from your AI's tool listConnector is on the Free tier, or the tools aren't selected for your clientUpgrade the Slide connector plan and check your tool selections on the MCP Setup page
Tool calls slow down under heavy useStackJack is pacing requests towards Slide's rate limitExpected under bursts. Narrow the request or reduce parallelism if it does not finish.

Slide tools

slide_ · 79 tools · Free 38 · Pro 41

Accounts

ToolWhat it does
slide_get_account
Free · Read-only
Get a single Slide account by account_id (from slide_list_accounts).
slide_list_accounts
Free · Read-only
List the Slide accounts visible to this API token.
slide_update_account
Pro · Write
Update a Slide account by account_id (from slide_list_accounts).

Users

ToolWhat it does
slide_get_user
Free · Read-only
Get a single Slide Console user by user_id (from slide_list_users).
slide_get_user_avatar
Free · Read-only
Get a Slide Console user's avatar by user_id (from slide_list_users).
slide_list_users
Free · Read-only
List the Slide Console users on the account.

Clients

ToolWhat it does
slide_create_client
Pro · Write
Create a client (end-customer grouping).
slide_delete_client
Pro · Destructive
Permanently delete a client by client_id (from slide_list_clients).
slide_get_client
Free · Read-only
Get a single client by client_id (from slide_list_clients).
slide_list_clients
Free · Read-only
List the clients (end-customer groupings) on the account.
slide_update_client
Pro · Write
Update a client by client_id (from slide_list_clients).

Alerts

ToolWhat it does
slide_get_alert
Free · Read-only
Get a single alert by alert_id (from slide_list_alerts).
slide_list_alerts
Free · Read-only
List alerts raised across the fleet (backup failures, appliance health, etc.).
slide_update_alert
Pro · Write
Update an alert by alert_id (from slide_list_alerts).

Audit Logs

ToolWhat it does
slide_get_audit_log
Free · Read-only
Get a single audit-log entry by audit_id (from slide_list_audit_logs).
slide_list_audit_actions
Free · Read-only
List the distinct audit action types recorded in the account (the vocabulary of actions that appear in slide_list_audit_logs).
slide_list_audit_logs
Free · Read-only
List audit-log entries (who did what, when) for the account.
slide_list_audit_resource_types
Free · Read-only
List the distinct resource types that appear in the account's audit trail (the vocabulary of resources referenced by slide_list_audit_logs).

Agents

ToolWhat it does
slide_add_agent_passphrase
Pro · Write
Add a user-managed backup encryption passphrase to an agent.
slide_create_agent
Pro · Write
Pre-pair an agent: reserve an agent slot and mint a pair code that the machine's installer redeems.
slide_create_nas_agent
Pro · Write
Create a NAS agent that backs up an SMB share.
slide_delete_agent_passphrase
Pro · Destructive
Remove a user-managed backup passphrase from an agent.
slide_get_agent
Free · Read-only
Get a single agent by agent_id (from slide_list_agents).
slide_list_agent_file_versions
Free · Read-only
List the point-in-time versions (across snapshots) of a specific file path on an agent.
slide_list_agents
Free · Read-only
List backup agents (protected machines).
slide_pair_agent
Pro · Destructive
Bind a machine to a Slide appliance using a pair code.
slide_search_agent_files
Free · Read-only
Search an agent's file index by filename/path fragment.
slide_update_agent
Pro · Write
Update an agent by agent_id (from slide_list_agents).

Devices

ToolWhat it does
slide_create_device_vlan
Pro · Write
Create a VLAN interface on a Slide appliance by device_id (from slide_list_devices).
slide_delete_device_vlan
Pro · Destructive
Delete a VLAN on a Slide appliance by device_id and vlan_id (both from slide_list_device_vlans).
slide_get_device
Free · Read-only
Get a single Slide appliance by device_id (from slide_list_devices).
slide_get_device_network
Free · Read-only
Get the primary network configuration of a Slide appliance by device_id (from slide_list_devices).
slide_get_device_vlan
Free · Read-only
Get a single VLAN on a Slide appliance by device_id and vlan_id (both from slide_list_device_vlans).
slide_list_device_vlans
Free · Read-only
List the VLAN interfaces configured on a Slide appliance by device_id (from slide_list_devices).
slide_list_devices
Free · Read-only
List Slide appliances (devices).
slide_poweroff_device
Pro · Destructive
Power off a Slide appliance by device_id (from slide_list_devices).
slide_reboot_device
Pro · Destructive
Reboot a Slide appliance by device_id (from slide_list_devices).
slide_update_device
Pro · Write
Update a Slide appliance by device_id (from slide_list_devices).
slide_update_device_network
Pro · Write
Update the primary network configuration of a Slide appliance by device_id (from slide_list_devices).
slide_update_device_vlan
Pro · Write
Update a VLAN on a Slide appliance by device_id and vlan_id (both from slide_list_device_vlans).

Backups

ToolWhat it does
slide_get_backup
Free · Read-only
Get a single backup run by its backup_id (from slide_list_backups).
slide_list_backups
Free · Read-only
List backup runs across the account, newest first.
slide_start_backup
Pro · Destructive
Trigger an on-demand backup run for an agent.

Snapshots

ToolWhat it does
slide_get_snapshot
Free · Read-only
Get a single snapshot (recovery point) by its snapshot_id (from slide_list_snapshots).
slide_list_snapshots
Free · Read-only
List snapshots (recovery points) across the account.

File Restores

ToolWhat it does
slide_browse_file_restore
Free · Read-only
Browse the file/folder tree inside a mounted file restore, identified by its file_restore_id (from slide_list_file_restores).
slide_create_file_restore
Pro · Write
Mount a snapshot as a browsable file restore so individual files can be inspected and pushed back.
slide_create_file_restore_push
Pro · Destructive
Push a recovered file from a mounted file restore back onto a protected system — this WRITES a file onto the live target and can overwrite existing data, so it is destructive.
slide_delete_file_restore
Pro · Destructive
Tear down a file restore (unmount the browsable snapshot) by its file_restore_id (from slide_list_file_restores).
slide_get_file_restore
Free · Read-only
Get a single file restore by its file_restore_id (from slide_list_file_restores).
slide_get_file_restore_push
Free · Read-only
Get the status of a single file-restore push by its file_restore_id and file_restore_push_id (both from slide_list_file_restore_pushes).
slide_list_file_restore_pushes
Free · Read-only
List the push-back operations for a file restore (identified by file_restore_id) — each attempt to copy a recovered file onto a protected system.
slide_list_file_restores
Free · Read-only
List the active file restores (mounted, browsable snapshots) in the account.
slide_update_file_restore_push
Pro · Write
Update an in-progress file-restore push — currently used to cancel it.

Image Exports

ToolWhat it does
slide_browse_image_export
Free · Read-only
Browse the contents of an exported image by its image_export_id (from slide_list_image_exports).
slide_create_image_export
Pro · Destructive
Start an image export — render a snapshot as a bootable disk image and boot/serve it.
slide_delete_image_export
Pro · Destructive
Permanently delete an image export by its image_export_id (from slide_list_image_exports), tearing down the exported image and any NFS share.
slide_get_image_export
Free · Read-only
Get a single image export by its image_export_id (from slide_list_image_exports).
slide_list_image_exports
Free · Read-only
List the image exports in the account.
slide_update_image_export
Pro · Write
Update an image export's NFS sharing settings by its image_export_id (from slide_list_image_exports).

Recovery Virtual Machines

ToolWhat it does
slide_create_virtual_machine
Pro · Destructive
Boot a recovery virtual machine from a snapshot (a test or disaster VM).
slide_delete_virtual_machine
Pro · Destructive
Permanently delete (shut down and discard) a recovery virtual machine by its virt_id (from slide_list_virtual_machines).
slide_get_virtual_machine
Free · Read-only
Get a single recovery virtual machine by its virt_id (from slide_list_virtual_machines).
slide_list_virtual_machines
Free · Read-only
List the recovery virtual machines booted from snapshots.
slide_update_virtual_machine
Pro · Write
Update a running recovery virtual machine by its virt_id (from slide_list_virtual_machines).

Networks

ToolWhat it does
slide_create_network
Pro · Write
Create a disaster-recovery network.
slide_create_network_ipsec_connection
Pro · Write
Add an IPsec site-to-site connection to a disaster-recovery network (network_id from slide_list_networks).
slide_create_network_port_forward
Pro · Write
Add a port-forward rule to a disaster-recovery network (network_id from slide_list_networks).
slide_create_network_wg_peer
Pro · Write
Add a WireGuard peer (client) to a disaster-recovery network (network_id from slide_list_networks; the network must have WireGuard enabled).
slide_delete_network
Pro · Destructive
Permanently delete a disaster-recovery network by its network_id (from slide_list_networks).
slide_delete_network_ipsec_connection
Pro · Destructive
Permanently delete an IPsec connection from a network by its network_id and ipsec_id, tearing down the site-to-site tunnel.
slide_delete_network_port_forward
Pro · Destructive
Permanently delete a port-forward rule from a network by its network_id and port_forward_id.
slide_delete_network_wg_peer
Pro · Destructive
Permanently delete a WireGuard peer from a network by its network_id and wg_peer_id, revoking that client's tunnel access.
slide_get_network
Free · Read-only
Get a single disaster-recovery network by its network_id (from slide_list_networks).
slide_list_networks
Free · Read-only
List the disaster-recovery networks in the account.
slide_update_network
Pro · Write
Update a disaster-recovery network by its network_id (from slide_list_networks).
slide_update_network_ipsec_connection
Pro · Write
Update an IPsec connection on a network by its network_id and ipsec_id.
slide_update_network_port_forward
Pro · Write
Update a port-forward rule on a network by its network_id and port_forward_id.
slide_update_network_wg_peer
Pro · Write
Update a WireGuard peer on a network by its network_id and wg_peer_id.