Guides

The longer reads — for when you want to understand how a piece of Driftstack works end-to-end, not just what one call does. Onboarding tutorials, common workflows, integration patterns. Concept-first writing for the parts of Driftstack that aren't obvious from a single endpoint reading.

Concept guides

• Profile management — persistent identities across sessions; cookies, storage, stealth state continuity.
• Session lifecycle — full state diagram, concurrency caps, duration caps, error shapes.
• Concurrency & backpressure — how the concurrent-session cap works and how to code around a full fleet.
• Team RBAC — invite, accept, act-as — end-to-end tutorial for setting up a multi-user team; invite + accept + X-Driftstack-Account header + audit-log review.
• Live video for agent sessions — subscribe to a running agent session's video stream over LiveKit WebRTC; covers token mint, connect, render, input forwarding, and reconnect.
• Migrating from Puppeteer / Playwright — concept mapping plus a side-by-side first script.
• Migrating from Browserless — action-based API instead of remote CDP; what changes and what maps over.
• Sentry integration — how Driftstack relates to your Sentry setup, and what our own error pipeline scrubs.
• Paying with crypto — the dashboard flow, the checkout API, the order lifecycle, safe retries, and receipts.
• Crypto payment troubleshooting — the "something looks stuck" decision tree, from pending orders to wrong-network sends.

Get started

• Quickstart — signup to first session in five minutes.
• Quickstart (curl) — the same path with raw HTTP, no SDK.
• SDK installation — install + configure each SDK.
• License activation — activate the desktop GUI client.

Architecture + reference

• API versioning policy — additive vs breaking, the deprecation cycle, when /v2/* is justified.
• Webhook events catalog — payload shape, signature verification, retry policy.
• SDK versioning policy — how SDKs version independently of the HTTP API.

Reference (in repo)

• Architecture overview — system shape, layers, request lifecycle, lifecycle event dispatcher, scheduled jobs.
• Team roles taxonomy — owner / admin / member / viewer; what each role can do in the dashboard.

Email [email protected] if you need a specific guide prioritized.