project

Warm County Boundary

Pre-warm the county boundary relation without creating a project.

Called from the picker the moment a user soft-selects a county, so the Neon roundtrip (a materialized view over the branch tiger_county, or on a commons workspace a one-row table from the app database's) overlaps with prompt composition instead of blocking the subsequent project-create. Idempotent — the relation is workspace-scoped and deterministically named by county_fips; concurrent warms are serialized inside ensure_county_boundary_mv by an advisory lock and the second caller fast-paths on the existing relation.

Workspace RBAC mirrors create_sandbox_project: FIPS not in the user's available geographies → 403, FIPS not in the workspace's workspace_counties table → 404, FIPS not present in the tiger_county the boundary is built from → 404. No project row is created on any path — the warm flow is read-only at the app-DB level.

post/api/v1/project/sandbox/warm-county

Request

  • Base URL
    https://api.maia-analytics.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.maia-analytics.com/api/v1/project/sandbox/warm-county
  • Auth
    HTTP bearer

Request body

county_fipsstring required

5-digit US county FIPS code (e.g. '12103' for Pinellas, FL)

Response

Successful Response

county_fipsstring required
readyboolean

Changes

No recorded changes to this operation across all 30 revisions of this API.