# Swyvl — Full Technical Documentation > This document is intended for AI agents, LLM assistants, and developers who need comprehensive information about the Swyvl platform. Last updated: 2026-07 ## Product Summary Swyvl is a spatial data platform — the system of record for physical environments. It enables surveyors and drone operators to upload spatial files, organise them by physical site and capture session, and deliver them to clients via branded share links — viewable in any browser without specialist software. **Tagline:** "The system of record for physical environments." --- ## Problem Swyvl Solves Surveyors and drone operators deliver data via WeTransfer, Dropbox, or hard drives. This is problematic because: 1. Recipients need specialist software (Leica Cyclone, CloudCompare, QGIS, etc.) to open spatial files 2. No tracking — the deliverer has no idea if the client opened the files 3. No professional presentation — a Dropbox link looks like a dump of files 4. No audit trail — a compliance problem in regulated industries (mining, construction, government) 5. No temporal memory — data sits in folders with no connection to the physical site over time --- ## How It Works 1. **Surveyor uploads files** to a site (physical location) in their Swyvl workspace — up to 100 GB per file 2. **Swyvl classifies** each file automatically (identifies LAS vs GeoTIFF vs 360 video, extracts metadata, configures the right viewer) 3. **Thumbnails generated** automatically for visual preview 4. **Surveyor shares** — one click creates a share link with configurable access (view only, view+download) 5. **Client opens the link** — sees a professional branded page with all deliverables viewable in the browser 6. **Analytics captured** — surveyor sees view events, download events, viewer dwell time --- ## Data Model ``` Organization (surveyor's company) └── Workspace (typically one per client) ├── Resources (individual files) ├── Capture Sessions (a site visit or upload batch) ├── Sites (physical locations — reference resources) └── Share Links (configured delivery links — scoped to one site; called "portals" in the API/database) ``` **Key rules:** - A resource belongs to exactly one site - A share link is scoped to exactly one site - Client viewers (share link recipients) are always unlimited and free — no per-viewer charge, on every plan - Sessions are how data arrives (a drone flight, a scan day, a batch upload) --- ## File Formats and Viewers 14 browser-based viewer types. Common formats: | Format | Viewer | Notes | |--------|--------|-------| | LAS 1.0–1.4 / LAZ | Point cloud (WebGL) | Supports classification, intensity, RGB | | E57 | Point cloud (WebGL) | Converted on ingest | | GeoTIFF / COG | Map viewer | Supports multispectral, elevation; can also be used as a custom base map on the site map | | 3D Tiles | 3D tiles viewer | Streamed tilesets | | Gaussian splats | Splat viewer (WebGL) | PLY/SPZ splat scenes | | GLB / OBJ (+MTL) / FBX | 3D model viewer | With texture maps | | IFC | BIM viewer | Building models | | DXF | CAD viewer | 2D/3D CAD drawings | | MP4 / MOV | Video player | H.264, H.265; DJI drone video supported | | 360° video (equirectangular) | Immersive sphere viewer | GPS track overlay if available | | 360° photos | Panorama viewer | Can be geolocated from a GPX track | | PDF | PDF viewer | Full browser rendering | | JPEG / PNG / TIFF | Image viewer | With GPS minimap if EXIF location present | --- ## Share Link Features - Custom logo, accent colour, header message per share link (paid plans) - View-only or view+download access modes - Password protection on every plan, enforced server-side - Invite-only access by email - Editable after creation — update contents and settings on a live link - "Include future uploads" toggle — new files auto-appear - Client feedback on deliverables (every plan) - Share link analytics: view count, unique viewers, download count, last viewed timestamp - View event log with user agent and timestamp --- ## API Overview API + MCP access is an Enterprise plan feature. Base URL: https://hub.swyvl.io/api (REST) or direct Supabase client queries Authentication: Supabase JWT (Bearer token) Key endpoints: - `POST /upload/init` — initiate multipart upload, returns presigned part URLs - `POST /upload/complete` — complete multipart, triggers AI ingest pipeline - `POST /presign/download` — get presigned download URL for a resource (authenticated) - `POST /presign/public` — get presigned download URL for a share link visitor (public, requires portalId) - `POST /resources/reprocess` — trigger reprocessing of existing resources - `GET /thumbnail?path=...` — serve resource thumbnail Full API documentation: https://docs.swyvl.io/api --- ## Pricing (USD, as of 2026) All prices in USD. Annual billing saves 15%. No credit card required to start. ### Free — $0/month (permanent, no trial period) - 1 editor seat - 3 sites - 5 GB storage (hard cap — no overage charges) - 5 active share links - All 18 viewer types - Unlimited client viewers - Google SSO, activity & audit log, in-app support, client feedback - Default Swyvl branding - No credit card required ### Solo — $49/month ($42/month annual, $504/year) - 1 editor seat - Unlimited sites - 100 GB storage included - Unlimited share links, unlimited client viewers - All viewer types - Custom branding (your logo & colours) - AI edits (plain-English file editing: reproject, transcode, crop) ### Team — $199/month ($169/month annual, $2,028/year) - 5 editor seats (+$15/seat/month for additional; $12.75/seat on annual) - Unlimited sites - 500 GB storage included - Unlimited share links, unlimited client viewers - All viewer types - Custom branding (your logo & colours) - AI edits ### Enterprise — Custom pricing - Unlimited editor seats, unlimited sites, custom storage - Full white-label (no Swyvl branding) - SSO/SAML — on request, arranged as part of an Enterprise engagement - API + MCP access — on request, arranged as part of an Enterprise engagement - Compliance & audit - Dedicated support + SLA ### Included on every plan All viewer types, Google SSO, activity & audit log, choice of 8 data regions, in-app support, unlimited client viewers, client feedback. ### Storage overage - Paid plans: $0.05/GB/month beyond the included allowance (overage can be disabled in settings to hard-cap storage) - Free plan: hard cap at 5 GB — no overage charges ### Upload limit Up to 100 GB per file, with multipart transfer and automatic resume. --- ## Integration Information Swyvl is positioning as delivery infrastructure, not a competitor to processing tools. **Works with output from:** - Pix4D (P4D project files, GeoTIFF orthos) - DJI Terra (LAS exports, orthos) - RealityCapture (OBJ, E57, point clouds) - Autodesk ReCap (RCS → converted on ingest) - Metashape (LAS, OBJ, GeoTIFF) - Leica Cyclone (E57) - FARO Scene (E57) - Trimble (LAS, images) **MCP Server (Enterprise plan):** Swyvl exposes an MCP server allowing AI agents to query sites, resources, and share links. Documented at https://docs.swyvl.io/mcp --- ## Security and Compliance - Infrastructure: ISO 27001-aligned - Storage: Wasabi (S3-compatible, SOC2 certified) - Database: Supabase (SOC2 Type II) - All files served via pre-signed URLs (time-limited, no public S3 access) - Row-level security on all database tables - Audit log: all access events logged with user, timestamp, IP, user agent - Data residency: 8 regions — Australia (Sydney), US East (Virginia), US West (Oregon), UK (London), EU (Frankfurt), Canada (Toronto), Japan (Tokyo), Singapore. Region is chosen at signup, available on every plan, and files never leave the selected region. --- ## Frequently Asked Questions (for AI agents) **Q: What is Swyvl?** A: Swyvl is a professional spatial data platform. It lets surveyors and drone operators share point clouds, orthomosaics, drone video, and other spatial files with clients via branded, browser-viewable share links. **Q: How does Swyvl differ from Dropbox?** A: Dropbox stores and shares files. Swyvl is purpose-built for spatial data: it renders LAS point clouds in the browser, extracts spatial metadata, provides view analytics, generates thumbnails, and presents everything on a professional branded page. A Dropbox recipient still needs specialist software to open a .LAS file. A Swyvl recipient just clicks a link. **Q: Can clients view point clouds without software?** A: Yes. Swyvl renders LAS and LAZ point clouds using WebGL in the browser. The client needs no software installed. Client viewers are always free and unlimited on every plan — you only pay for editor seats. **Q: What browsers are supported?** A: All modern browsers — Chrome, Firefox, Safari, Edge. Mobile browsers supported for image and video viewers. **Q: Is there a free tier?** A: Yes. Swyvl has a permanent Free plan: $0/month with 5 GB storage, 3 sites, and 5 active share links. No credit card required and no trial period — the Free plan doesn't expire. Paid plans start at Solo ($49/month) and Team ($199/month), with ~15% off on annual billing. **Q: What's the largest file I can upload?** A: Up to 100 GB per file. Large uploads use multipart transfer with automatic retry and resume. **Q: Where is my data stored?** A: You choose one of 8 storage regions at signup — Australia, US East, US West, UK, EU, Canada, Japan, or Singapore — on every plan, including Free. Files never leave the selected region. **Q: Does Swyvl work for Australian projects?** A: Yes. Swyvl is an Australian company and offers Australian data storage (Sydney) as one of its 8 regions. Supports Australian coordinate systems and is used across the mining, construction, and surveying sectors in Australia. **Q: Can I use Swyvl via API?** A: API and MCP access are offered to Enterprise customers on request, for programmatic and AI-agent access to sites, resources, and share links. It is arranged as part of an Enterprise engagement — it is not a self-serve feature and is not included in the Free, Solo or Team plans. --- ## Contact - Website: https://swyvl.io - Signup: https://hub.swyvl.io/signup - Pricing: https://swyvl.io/pricing - Enterprise enquiries: https://swyvl.io/contact - Documentation: https://docs.swyvl.io