Integrations & APIs

How SweepTag connects with external systems and services.

---

Lansweeper Integration

Overview

SweepTag integrates with Lansweeper to provide barcode generation for your entire IT infrastructure.

What's supported:

• ✅ Browse all Lansweeper assets across multiple sites
• ✅ Search assets with live search (debounced)
• ✅ View comprehensive asset details (30+ data points)
• ✅ Generate QR or Code 128 barcodes
• ✅ Link barcodes to Lansweeper URLs
• ✅ Create custom fields for barcode storage
• ✅ Multi-site queries with single PAT
• ✅ Automatic asset sync and caching

What's not supported (yet):

• ❌ Asset creation in Lansweeper from app
• ❌ Asset deletion from app
• ❌ Custom field deletion from app
• ❌ Direct field editing for Lansweeper assets

Authentication

SweepTag uses Personal Access Tokens (PAT) from Lansweeper.

Prerequisites:

• Lansweeper account with API access (not available on free tier)
• Administrative access to create PAT

To generate a PAT:

1. Log in to Lansweeper (https://app.lansweeper.com)
2. Go to Settings › API & Webhooks
3. Click "Create Token"
4. Name it (e.g., "SweepTag Mobile")
5. Choose permissions:
   • assets:read - View assets
   • assets:write - Create/edit custom fields
   • (Other scopes as needed)
6. Copy the token
7. Paste into SweepTag (Settings › Integrations › Lansweeper › Add Connection)

Security:

• PAT is stored locally on your device
• Never shared or sent to external servers
• If compromised, you can revoke it in Lansweeper
• Use a dedicated PAT for mobile app (separate from API scripts)

API Endpoints Used

SweepTag queries the Lansweeper GraphQL API at: https://api.lansweeper.com/graphql (or your custom instance URL)

Operations performed:

• GetSites - Discover authorized sites
• GetAssets - List assets per site (paginated)
• GetAssetDetail - Full asset information (30+ fields)
• GetCustomFields - List available custom fields
• CreateCustomField - Add new custom text fields
• WriteBackToAsset - Write barcode values to custom fields

Rate limiting:

• SweepTag respects Lansweeper rate limits (typically 1000 requests/min)
• Caching minimizes unnecessary API calls
• Sync is automatic (configurable interval)

Multi-Site Support

If your PAT has access to multiple sites, SweepTag auto-discovers them.

To see all sites:

1. Go to Assets tab › Select Lansweeper
2. All authorized sites appear in the site list
3. Select a site to browse its assets

To generate barcodes for multiple sites:

1. Go to Codes tab
2. Select "Lansweeper"
3. Choose a site or "All Sites"
4. Use batch generate to create barcodes for all

Custom Field Management

Lansweeper has many built-in fields, but some are read-only on cloud assets. SweepTag lets you create custom text fields.

To create a custom field:

1. In SweepTag, go to Settings › Lansweeper
2. Tap "Create Custom Field"
3. Enter a name (e.g., "Barcode ID")
4. Confirm
5. Field is created on all sites authorized by your PAT

Available field types in Lansweeper:

• Text (single line)
• Text (multi-line)
• Number
• Date
• Choice
• User
• Asset link

SweepTag creates: Text fields (simplest, most flexible)

Caching & Sync

SweepTag caches Lansweeper data locally for offline access.

What's cached:

• Asset lists (name, type, OS, owner, etc.)
• Asset details (full profiles with 30+ fields)
• Custom field definitions

What's NOT cached:

• Live Lansweeper UI data
• Real-time asset updates

Cache behavior:

1. First open: SweepTag fetches latest from Lansweeper
2. Subsequent opens (within refresh interval): Uses cached data (faster)
3. After refresh interval expires: Auto-fetches fresh data (if online)
4. Offline: Uses cached data (no errors)

Cache refresh settings:

• Location: Settings › Advanced › Cache Refresh Interval
• Options: 1 hour, 4 hours (default), 12 hours, 24 hours, manual only

To force a refresh:

1. Go to Assets › Lansweeper › [site]
2. Tap refresh icon 🔄
3. SweepTag fetches latest data

Troubleshooting Lansweeper Connection

Connection fails: "Invalid token"

• Verify PAT is correct (copy-paste from Lansweeper)
• Ensure PAT hasn't expired (revoke and create new in Lansweeper)
• Check that you have API access (not free tier)

Can't see my sites

• Verify PAT has access to the sites (check in Lansweeper › Settings › API)
• Create a new PAT with broader permissions
• Try force-refreshing cache

Can't create custom field

• Ensure you have permission to create fields (admin access)
• Field name may conflict with existing field (try different name)
• Check internet connection

Assets show outdated data

• Manually refresh cache (see above)
• Wait for auto-refresh interval to pass
• Clear cache and re-sync

Scanning Lansweeper barcode doesn't show asset

• Ensure barcode was created with "Asset Key" link type
• Asset may have been deleted in Lansweeper
• Try re-syncing cache

---

Local Database System

Supported Field Types

SweepTag supports 9 field types for local databases:

Field Groups

Organize related fields together.

Use case example:

• Group: "Warranty Information"
  • Warranty Status (choice)
  • Warranty Expiration (date)
  • Warranty Provider (text)

Benefits:

• Cleaner UI when editing assets
• Logical organization
• Easier to find related information

Data Export

Export your local assets as CSV or JSON.

CSV export:

• Opens in Excel, Google Sheets, etc.
• One row per asset
• One column per field
• Easy for data analysis or backup

JSON export:

• Preserves full structure and data types
• For data migration or backup
• Readable in any text editor

Backup & Recovery

Automatic backup:

• SweepTag saves all data locally
• Data persists even if app is uninstalled
• Reinstalling app restores data (if using same device)

Manual backup:

1. Go to Assets tab › Select database
2. Tap export icon
3. Choose CSV or JSON
4. Save file to email, cloud storage, or device

Recovery from backup:

1. Create new database
2. Go to Assets tab › Select database
3. Tap import icon
4. Select your CSV/JSON backup file
5. SweepTag imports all assets

---

Deep Linking

SweepTag supports deep links for direct navigation.

URL scheme: sweeptag://

Supported links:

• sweeptag://asset/{assetId} - Open asset detail
• sweeptag://scan/{barcodeValue} - Simulate barcode scan
• sweeptag://database/{databaseId} - Open database

Examples:

• From website: <a href="sweeptag://asset/12345">View in SweepTag</a>
• From email: Click link to open app directly to asset
• From QR code: Barcode points to sweeptag://asset/{id}

Use cases:

• Customer self-service: Embed link in documentation
• Cross-app integration: Link from other apps to SweepTag
• Workflows: Deep-link to specific assets or databases

---

Planned Integrations

Graphiti (Temporal Knowledge Graph)

Timeline: Roadmap
Purpose: AI-powered asset queries
Examples:

• "Which laptops are past warranty?"
• "Show me all assets in Building A with 8+ GB RAM"
• "Which devices haven't been scanned in 30 days?"

Status: In development, not yet available.

Cloud Sync

Timeline: Roadmap
Purpose: Sync databases across devices and team members
Examples:

• Share inventory across team
• Edit on phone, access on tablet
• Real-time collaboration
• Cloud backup

Status: Planned feature, not yet available.

Credential Storage

Timeline: Roadmap
Purpose: Secure encrypted storage of Lansweeper PAT
Current: PAT stored locally on device
Future: Encrypted vault, recovery options

Status: Security enhancement planned.

Advanced Reporting

Timeline: Roadmap
Purpose: Generate reports from scan/barcode data
Examples:

• Weekly asset audit reports
• Barcode generation statistics
• Scan activity by user/date/asset
• Compliance documentation

Status: Planned feature, not yet available.

---

API for Developers (Future)

SweepTag does not currently expose a public API, but this is planned.

Future API would support:

• Export barcode data programmatically
• Create/manage assets via API
• Query scan history
• Integrate SweepTag with your systems

Status: Under consideration for future release.

---

Troubleshooting Integrations

Lansweeper

See Troubleshooting Lansweeper Connection above.

Local Databases

Can't import CSV

• Verify CSV format (columns match field names)
• Ensure no encoding issues (save as UTF-8)
• Check that required fields (Name) are present

Data lost after reinstalling app

• Data is stored locally per device
• Reinstalling on same device = data persists
• Switching devices = data doesn't transfer (use manual backup/export)

Export file won't open in Excel

• Ensure CSV is saved with UTF-8 encoding
• Try opening as "Text" file and specifying CSV format
• Check that column count matches field count

---

Data Privacy & Security

What Data SweepTag Sends

Sent to Lansweeper API only:

• Asset queries (requesting asset data)
• Custom field creation requests
• Barcode value write-backs
• Your Personal Access Token (via HTTPS)

Sent to SweepTag servers:

• None (SweepTag is offline-first)

Stored on your device:

• Local database assets (encrypted)
• Lansweeper asset cache
• Barcode history
• Scan history
• Settings and preferences

What SweepTag Does NOT Do

• ❌ Does not phone home or send analytics
• ❌ Does not share data with third parties
• ❌ Does not sell user data
• ❌ Does not require account creation
• ❌ Does not track location (except manual scan logging)
• ❌ Does not access contacts, photos, or other personal data

Data Retention

Local data: Stored indefinitely until deleted by user
Cache data: Refreshed per configured interval (can be manually cleared)
Scan history: Stored indefinitely (can be cleared in Settings)
Barcode history: Stored indefinitely (can be cleared in Settings)

Resetting Your Data

To clear all data:

1. Go to Settings › Advanced › Factory Reset
2. Tap "Reset All Data"
3. Confirm

This removes:

• All settings
• All local database assets (if not exported)
• All scan history
• All barcode history

---

Performance & Limitations

Asset Browsing

• Per-page limit: 200 assets (Lansweeper limit)
• Search result limit: 1000 assets
• Pagination: Cursor-based (efficient for large datasets)
• Performance: Instant search with 400ms debounce

Barcode Generation

• Batch generation: Up to 1000 barcodes per batch
• File size: PNG ~5-10 KB per barcode, SVG ~2-3 KB
• Generation speed: ~100 barcodes per second (varies by device)

Printing

• Simultaneous print jobs: 1 (sequential printing)
• Label sizes: 3 standard (small, medium, large)
• Custom sizes: Supported via printer settings

Caching

• Max asset cache size: ~50 MB (device dependent)
• Max scan history: Unlimited (only device storage)
• Cache retention: Per configured refresh interval

Multi-Database Support

• Maximum local databases: No limit (device storage dependent)
• Maximum assets per database: No limit (device storage dependent)
• Maximum Lansweeper connections: No practical limit

---

Roadmap Integration Status

See Limitations & Roadmap for planned features and timeline.