Skip to main content

Source Watching

When you import a collection from a local file or URL, Rostyman remembers the source and watches it for changes. When the source is updated, you get a notification with a one-click sync option.

How It Works​

  1. Import a collection from a local file (Postman JSON, OpenAPI, etc.) or from a URL
  2. Rostyman saves the source path or URL alongside the collection
  3. Periodically, it checks whether the source has changed
  4. If a change is detected, a notification appears with a Sync Now button
  5. Click Sync Now to update your collection with the latest version

Your local customizations (renamed requests, added scripts, folder structure changes) are preserved where possible during sync.

Supported Sources​

TypeExamples
Local file.json, .yaml, .rostyman, .har, and other supported import formats
URLAny publicly accessible URL returning a valid collection or API spec

Import from URL​

  1. Press Ctrl+O (or File → Import)
  2. Select the URL tab
  3. Paste a URL (e.g., a raw GitHub link to a Postman collection or OpenAPI spec)
  4. Click Import

The collection is created and the URL is saved as the watched source automatically.

Configuring the Check Interval​

  1. Go to Settings → Import
  2. Find Source watch interval
  3. Choose a frequency: every 5 minutes, 15 minutes, 1 hour, on startup only, or manually

Set a longer interval to reduce background activity. Choose Manually only to check on demand via right-click → Re-import from Source.

Change Notifications​

When a source change is detected:

  • A notification appears in the Notifications Center (right panel → bell icon)
  • The notification names the collection that has an update
  • Click Sync Now to import the updated version, or Dismiss to keep the current version
  • If the app is minimized, a native OS notification is also shown

Viewing the Watched Source​

The watched source path or URL is shown in the Collection Overview tab. From there you can:

  • See the last sync time
  • Manually trigger a re-import via Re-import from Source
  • Remove the source link if you no longer want to watch it