---
title: "Prewarm County Primitives"
method: POST
path: "/api/v1/map/county/{county_fips}/primitives/prewarm"
tags: ["map"]
---

# Prewarm County Primitives

`POST /api/v1/map/county/{county_fips}/primitives/prewarm`

Render the county's preview tiles into the cache, ahead of any query.

Returns as soon as the work is scheduled: the caller is a county click, and
the point is that the render is already finished by the time a query is
submitted. The sandbox target is resolved *before* handing off, because the
background task outlives this request's DB session.

## Path parameters

- `county_fips` string, required

## Query parameters

- `token` string, nullable — Firebase ID token for MVT authentication
- `project_id` string, uuid, nullable

## Response `202`

Successful Response

- CountyPrewarmResponse — Outcome of scheduling a county's preview tiles. ``scheduled`` is False when the county has no boundary on file — the caller treats that as "no preview available" rather than an error, because a missing boundary is an unseeded environment, not a bad request.
  - `scheduled` boolean, required
  - `tile_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-28** `0c94a4b5a00e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/map/county/:county_fips/primitives/prewarm/post.md)

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/0382310d5ade/schema)