Data Residency

Allternit’s Data Residency API lets organization owners and admins pin data processing and storage to a set of approved cloud regions. You can also enforce region pinning so that requests are rejected if they cannot be served from the pinned regions.

Authentication and authorization

Data residency endpoints require a Clerk JWT or a valid organization access token. Only organization owners and admins can view or modify the policy.

Base URL

Endpoints

Available regions

Response

Get the current policy

Response

If no policy has been set, the response returns the organization ID with an empty region list, no default region, and enforce_region_pinning set to false.

Set the residency policy

Request body

Response

default_region must be one of the pinned_regions. All regions in pinned_regions must be from the supported region list.

Policy behavior

  • Pinned regions — inference and storage requests are routed to one of the listed regions when possible.
  • Default region — the preferred region when no explicit region is requested.
  • Enforce region pinning — when true, requests that cannot be served from a pinned region are rejected.

Request/response fields

Error codes