Skip to main content

Globally distributed service

Our avatar service runs in multiple regions. You can choose the region that’s closest to your infrastructure to minimize latency.

Available regions

Use these region names when selecting a deployment:
  • ap-northeast
  • us-west

Console API hosts

When a doc example uses <console-api-host>, substitute the host for your region:
Region<console-api-host>
ap-northeastconsole.ap-northeast.spatialwalk.cloud
us-westconsole.us-west.spatialwalk.cloud

Cross-region portability

The following identifiers/credentials are not region-specific and can be used across regions:
  • App ID
  • API Key
  • Avatar ID
  • Session Token (generated by the console API)
This means you can switch regions or run multi-region without recreating apps, rotating keys, or re-uploading avatars.

How to pick a region

  • For lowest latency: choose the region closest to your largest user population.
  • For global audiences: you can route users to the nearest region (or a primary + secondary region).

High availability with regional fallback

Regions run on separate infrastructure, so you can improve availability by implementing fallback:
  • Primary + backup: if requests to the primary region fail (timeouts / 5xx), retry against another region.
  • Data sync: since the identifiers/credentials mentioned above are portable, you can keep using them when failing over to another region.