paragon-managed-sync-skill

When to use this skill

Use this Skill to help the user implement Managed Sync with the Sync API and the Permissions API, using the references in the Table of Contents.

Managed Sync Overview

Managed Sync is a set of APIs for developers to spin up data pipelines that pull their users' 3rd-party integration data (like Salesforce CRM data, Google Drive file data, and ServiceNow tickets) and keep that data up-to-date. These data pipelines live in Paragon's infrastructure and are completely managed by Paragon. Developers can easily start syncs, pause syncs, and pull synced data.

When integration data is synced, that data is also normalized across that integration's category. For example, the data schema from Google Drive, Dropbox, Box, and Sharepoint are all normalized so that code/logic can be used across that category.

For file storage integration data, the Permissions API is an API to check permissions of any synced file. Paragon manages a graph database behind the scenes, so developers can get and check up-to-date permissions without managing that data.

Prerequisites

Managed Sync is built on top of Paragon's managed authentication and monitoring. When using any Sync APIs or Permissions APIs, a JWT with a unique end-user ID is required so that Paragon knows which end-users data to sync.