Skip to main content

Workspace Regions

Regions represent geographic MQTT infrastructure deployments. Activating a region in your workspace provisions connectivity to that region's MQTT broker.

List available regions​

GET /regions

Returns all available IOTMER regions. Use the code field when activating a region in your workspace.

Activate a region​

  1. Go to Workspace Settings → Regions
  2. Click Add Region
  3. Select the region and the MQTT service type (Cloud or Dedicated)
  4. Click Activate

Or via API:

POST /workspaces/{id}/regions
Content-Type: application/json

{
  "region_code": "eu-west-1"
}

Deactivate a region​

Deactivating removes the MQTT endpoint for that region from your workspace. Existing device credentials tied to that region will stop working.

See DELETE /workspaces/{id}/regions/{region_code}.