---
title: "Update Region Admin"
method: PATCH
path: "/admin/regions/{region_id}"
tags: ["admin"]
---

# Update Region Admin

`PATCH /admin/regions/{region_id}`

Edit/disable a region. Re-runs the scoped backfill over the UNION of the
old + new bboxes so a shrunk or disabled outline un-tags the places that
left it (§2.5; for a pure enable/disable toggle old == new — one scan).

## Path parameters

- `region_id` string, required

## Request body

- RegionUpdateRequest — PATCH: every field optional; omitted fields keep their stored value.
  - `name` string, nullable
  - `outline` object, nullable
  - `area_km2` number, nullable
  - `source` 'osm-relation' | 'admin-union' | 'hand-drawn', nullable
  - `source_refs` string[], nullable
  - `enabled` boolean, nullable

## Response `200`

Successful Response

- RegionDetail — Full region incl. the GeoJSON outline (for the map preview).
  - `id` string, required
  - `name` string, required
  - `area_km2` number, required
  - `source` string, required
  - `source_refs` string[], required
  - `enabled` boolean, required
  - `member_count` integer, required
  - `backfill_status` BackfillStatus, required — The scoped backfill's progress, as the admin page polls it.
    - `state` 'queued' | 'running' | 'done' | 'error', required
    - `scanned` integer
    - `tagged` integer
    - `changed` integer
    - `error` string, nullable
    - `updated_at` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `outline` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)