---
title: "Create a region"
method: POST
path: "/api/regions"
tags: ["region-controller"]
---

# Create a region

`POST /api/regions`

Add a region to the repository.

## Request body

- RegionReq
  - `approvals` object
  - `createdDtm` TimestampReq
    - `date` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `year` integer
  - `description` string
  - `id` string
  - `locales` string[]
  - `name` string
  - `permittedOperations` string[]
  - `status` 'ACTIVE' | 'ARCHIVED' | 'PENDING'

## Response `201`

Created

- RegionRes
  - `approvals` object
  - `createdDtm` TimestampRes
    - `date` integer
    - `day` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `timezoneOffset` integer
    - `year` integer
  - `description` string
  - `href` string
  - `id` string
  - `locales` string[]
  - `name` string
  - `permittedOperations` string[]
  - `status` 'ACTIVE' | 'ARCHIVED' | 'PENDING'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Unexpected error in processing the request.

---

[API](https://skmtc.dev/myverifly/apis/api-documentation.md) · [All operations](https://skmtc.dev/myverifly/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myverifly/api-documentation/revisions/03f300608c33/schema)