---
title: "Create Scale Region"
method: POST
path: "/api/v1/pages/{page_id}/scale-regions"
tags: ["scale-regions"]
---

# Create Scale Region

`POST /api/v1/pages/{page_id}/scale-regions`

## Path parameters

- `page_id` string, uuid, required

## Request body

- CreateScaleRegionForRevisionRequest
  - `x` union, required
    - number
    - string
  - `y` union, required
    - number
    - string
  - `width` union, required
    - number
    - string
  - `height` union, required
    - number
    - string
  - `name` string, nullable
  - `color` string, nullable
  - `revision_set_id` string, uuid, nullable, required

## Response `201`

Successful Response

- ScaleRegion — A single rectangular scale region on a page. `scale_ratio` / `calibration` are None until the region is calibrated; an uncalibrated region is inert for scale resolution (spec §5.1).
  - `id` string, uuid, required
  - `project_id` string, uuid, required
  - `page_id` string, uuid, required
  - `name` string, required
  - `color` string, required
  - `x` string, required
  - `y` string, required
  - `width` string, required
  - `height` string, required
  - `scale_ratio` string, nullable
  - `calibration` CalibrationDataOutput — User-entered calibration tuple, the shape stored in pages.calibration JSONB.
    - `drawing_distance` string, required
    - `drawing_units` 'in' | 'ft' | 'mm' | 'cm' | 'm', required
    - `actual_distance` string, required
    - `actual_units` 'in' | 'ft' | 'mm' | 'cm' | 'm', required
    - `source` 'standard' | 'manual' | 'calibrate', required
    - `description` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `scale_source` 'autoset' | 'user' | 'import', required
  - `suggested_notation` string, nullable
  - `suggested_ratio` string, nullable
  - `prior_violated` boolean, nullable

## Other responses

- `4XX` — Client Error
- `5XX` — Server Error

---

[API](https://skmtc.dev/rudus/apis/rudus-api.md) · [All operations](https://skmtc.dev/rudus/apis/rudus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rudus/apis/rudus-api/revisions/5673f72c8a5d?raw)