---
title: "Create a new AOI"
method: POST
path: "/v0/aois"
tags: ["AOI"]
---

# Create a new AOI

`POST /v0/aois`

Creates a new AOI with specified parameters

## Request body

- AtlasAOICreateModelV2
  - `name` string, required — Unique user friendly name of the AOI for easier identification
  - `description` string, required — Brief description of the AOI explaining its purpose or contents
  - `satellite_id` string, required — Unique identifier (UUID) for the satellite. Each satellite has a unique ID mapped to its name: - `Pixxel-TD1` - `0004ab8d-0ad1-4d62-8a3f-fe18a7000e70` - `Pixxel-TD2` - `0005c5bb-0bd2-4c80-9393-4a808341c54c`
  - `provider` string, required — Data provider source for satellite imagery: - `pixxel` - For TD and Firefly satellite imagery - `planetary` - For all open source satellite data (Landsat, Sentinel, etc.)
  - `project_id` string, required — UUID of the project this AOI belongs to. The AOI will be associated with this project for organization
  - `geometry` AtlasPolygon, required
    - `type` string, required — GeoJSON geometry type. Must be "Polygon" for AOI boundaries
    - `coordinates` array[], required — Nested array of coordinates [[[lng,lat],...]] forming a closed polygon. Example: [[[49.32, 40.85], [49.32, 9.08], [110.7, 9.08], [110.7, 40.85], [49.32, 40.85]]]
      - array[]
        - number[]
  - `item_ids` string[], required — Array of satellite image item IDs to include in this AOI. Item IDs Example: `["TD2_000650_20230404_L2A_20240405_01001067", "TD1_005630_20230314_L2A_20230504_03001069"]`

## Response `201`

Created

- AtlasAOI
  - `aoi_id` string — Unique identifier (UUID) of the created AOI
  - `name` string — Unique user friendly name of the AOI for easier identification
  - `description` string — Brief description of the AOI explaining its purpose or contents
  - `satellite_id` string — Unique identifier (UUID) for the satellite. Each satellite has a unique ID mapped to its name: - `Pixxel-TD1` - `0004ab8d-0ad1-4d62-8a3f-fe18a7000e70` - `Pixxel-TD2` - `0005c5bb-0bd2-4c80-9393-4a808341c54c`
  - `project_id` string — UUID of the project this AOI belongs to
  - `images` object — Map of images associated with the AOI, keyed by image identifier
  - `eo_bands` string[] — List of Earth Observation bands available for this AOI
  - `geometry` AtlasPolygon
    - `type` string, required — GeoJSON geometry type. Must be "Polygon" for AOI boundaries
    - `coordinates` array[], required — Nested array of coordinates [[[lng,lat],...]] forming a closed polygon. Example: [[[49.32, 40.85], [49.32, 9.08], [110.7, 9.08], [110.7, 40.85], [49.32, 40.85]]]
      - array[]
        - number[]
  - `progress` integer — Processing progress of the AOI from 0 to 100 in percentage
  - `status` 'success' | 'started' | 'running' | 'failed' | 'updating' | 'partial_success'
  - `is_favourite` boolean — Whether the AOI is marked as favourite by the user
  - `created_at` string — Timestamp when the AOI was created (ISO 8601 format)
  - `updated_at` string — Timestamp when the AOI was last updated (ISO 8601 format)
  - `user_id` string — Unique identifier of the user who created the AOI
  - `area_in_sq_m` number — Total area of the AOI in square meters
  - `centroid` number[] — Geographic centroid coordinates of the AOI [longitude, latitude]

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/versions/b501e2ca5a9d/schema)