Sign in

v4

latestOpenAPI 3.1.02026-08-08278476614.0 KB
internal
workspaces

List Workspace Counties

Return per-county sandbox load state for the workspace.

get/api/v1/internal/workspaces/{workspace_id}/counties

Path parameters

workspace_idstring uuid required

Response

Successful Response

idstring uuid required
workspace_idstring uuid required
statestring required
county_fipsstring required
county_namestring required
load_status'provisioning' | 'pending' | 'loading' | 'succeeded' | 'failed' | 'canceled' required

Load status for a workspace-county pair.

Lifecycle: provisioning (initial — set by workspace standup before the Neon project is ready) → pending (set by provision_workspace_op after schema apply succeeds; the pickup sensor's gate value) → loading (set by sandbox_load when it starts writing for one county) → succeeded | failed (terminal, set by the asset's try/finally). provisioning and the mid-load loading were previously the same value; MAIA-2309 split them so the lifecycle reads literally instead of overloading loading across two phases.

canceled is the admin-initiated terminal state: an in-flight (pending/loading) row canceled before the load finished. The Dagster stamps are status-guarded so a canceled row is never resurrected by a run that was already queued; retry via the reload seam re-queues it.

dagster_run_idstring nullable required
requested_atstring date-time required
completed_atstring date-time nullable required
suspended_atstring date-time nullable required
error_messagestring nullable required