Back to API overview
Regions

Create a region

POST/v1/regions Bearer API key

Define a geographic area of interest that missions, imagery searches, and analyses operate against.

A region is the spatial anchor for everything on the platform. Supply a GeoJSON geometry and a friendly name; the region id it returns is referenced by missions, imagery searches, and analysis jobs. Regions are reusable across many missions.

Request body

namerequiredstring

Human-readable label for the region.

geometryrequiredGeoJSON

A GeoJSON Polygon or MultiPolygon describing the area of interest.

tagsoptionalstring[]

Optional labels for organizing regions in a workspace.

Response fields

idoptionalstring

Unique region identifier, e.g. reg_central_valley.

nameoptionalstring

The label you supplied.

area_km2optionalnumber

Computed area of the region in square kilometers.

created_atoptionaltimestamp

ISO 8601 creation time.

curl -X POST https://api.satellitex.ai/v1/regions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Central Valley",
    "geometry": { "type": "Polygon", "coordinates": [[[-121.8,36.9],[-119.9,36.9],[-119.9,38.4],[-121.8,38.4],[-121.8,36.9]]] }
  }'

Illustrative API — keys and identifiers are for demonstration.

Related endpoints

Ready to build with this?

Request access and we'll help you scope your first mission and provision API keys.

Request API access