Appendix: service limits
Applies to SWATGenX engine extensions · Updated August 2026
Size, storage, concurrency, and coverage limits enforced on model generation — engineering constants from the live build paths and storage policy.
Limits below are taken from the live build paths and storage policy. Prefer this page over older public API markdown that still documents a 15-HUC12 cap and HUC8 as a restricted path. Accounts are by invitation. "Extended access" below is the server’s larger gate; an account with standard access does not pass it.
Storage-first limits
- Storage is set per account and read from the server. An account with standard access has the fallback allocation (
SWATGENX_BASIC_STORAGE_LIMIT_BYTES). - Concurrency: standard access 1 build at a time; extended access up to 3 (extras queue). Env:
SWATGENX_BASIC_MAX_CONCURRENT_BUILDS/SWATGENX_PRO_MAX_CONCURRENT_BUILDS. - Over storage quota → new builds blocked for any basin size (reason storage_limit).
Explorer outlet-HUC12 size cap (standard access)
- POST
/api/model-settings/explorer-watershed: for an account with standard access, the server refuses a resolved watershed larger thanSWATGENX_BASIC_MODEL_MAX_HUC12(default 35), with error_code model_basic_huc12_cap. - The same refusal names the HUC8 build path as the way to take one full HUC8 at any access level.
- Every account: watershed must lie in a single VPUID (error_code model_cross_vpuid); cross-VPU basins can be explored but not built yet.
- Extended access: the Explorer safety ceiling for very large single-region walks defaults to 300 HUC12 (
SWATGENX_EXPLORER_MAX_WATERSHED_PRO), clamped 16–500.
Station, HUC8, catchment-set paths
- POST
/api/model-settings(USGS station): storage + fair-use quotas apply; the old 15 contributing-HUC12 hard block is not applied on this path (huc12_count is still recorded). - POST
/api/model-settings-huc8: open with model access; storage quota is the limit. - Catchment-set builds: open with model access; storage_gate is the constraint.
Fair use, and what a study adds
- Your account counts the models you keep with us, not the ones you build. Delete a model and its place opens again. Rebuilding a model you keep does not count twice, and a failed build is not a kept model.
- Calibration inside the build is part of a study we do for you (code calval_pro_only). On-demand calibration from Calibration & Validation runs on cloud compute for an invited account with active access and calibration credit.
- SWAT+MODFLOW-6 (Michigan Lower Peninsula, Indiana, Minnesota, Ohio, Wisconsin), the choice of model resolution and the advanced QSWAT settings are part of a study we do for you; see Work with us (/work-with-us).
Flood / PDF report paths may still reference BASIC_MAX_HUC12_SUBBASINS = 15 for report eligibility — that constant is separate from the explorer model-build cap of 35.
