Skip to content

Advanced Usage

These pages cover power user features, optimization techniques, and advanced patterns.

Optimization Techniques

  • Performance Optimization — How to choose the right iteration method, use the SDK's async support, and implement parallel processing.

  • Reloading and Caching - How to efficiently retrieve fresh data and minimize redundant fetches

SDK Internals

  • Low-Level API Access - How to call unexposed endpoints directly, extend the client with custom methods, and work with raw SDK models

Search & Filtering

  • Advanced Search (fw.search()) — When to reach for fw.search() instead of a finder, the FlyQL query language, the correct call pattern, operators and their runtime behavior, saved searches, and discovering searchable fields.

Bulk and Batch Operations

  • Bulk Container Creation — Create many containers idempotently and collect per-item errors so a large run is safe to repeat after a partial failure.

  • Bulk Metadata Updates — Apply info, tag, and file classification changes across a filtered set of containers, and validate the change set before committing it.

  • Bulk File Operations — Upload many files with progress reporting, download whole containers as a tar or zip archive, and process large file sets without exhausting memory.

  • Bulk Move Sessions — Relocate many sessions into one destination in a single server-side call, with conflict previews and auto-relabelling.

  • Running Gears in Batch — Schedule one gear across many containers in a single proposal, then run, monitor, and cancel the resulting jobs as a group.