diff --git a/docs/api/index.mdx b/docs/api/index.mdx index 1cc66825f444c..69cf8ad8c6b64 100644 --- a/docs/api/index.mdx +++ b/docs/api/index.mdx @@ -20,3 +20,16 @@ Sentry's web API is **v0** and under development. Public endpoints, especially t - [Requests](/api/requests/) - [Tutorial: Create a Sentry Authentication Token](/api/guides/create-auth-token/) - [Tutorial: Create and List Teams with the Sentry API](/api/guides/teams-tutorial/) + +## Choosing the Right API Base Domain + +While many of our APIs use `sentry.io` as the host for API endpoints, if +you want to indicate a specific [data storage location](/organization/data-storage-location/#what-types-of-data-are-stored-where), you should use region-specific domains. + +- US region is hosted on `us.sentry.io` +- DE region is hosted on `de.sentry.io`. + +To find out which API resources are available on region-based domains, see [what +types of data are stored +where](/organization/data-storage-location/#what-types-of-data-are-stored-where) for more information. + diff --git a/docs/organization/data-storage-location/index.mdx b/docs/organization/data-storage-location/index.mdx index 6ba3619e740b0..00ba4bc2ef0ea 100644 --- a/docs/organization/data-storage-location/index.mdx +++ b/docs/organization/data-storage-location/index.mdx @@ -53,9 +53,19 @@ Here’s a list of the types of data that may be stored in the US. - Sentry applications - SSO, SAML, and SCIM metadata - Metadata that lets Sentry identify an organization will be replicated out of the organization's data storage location to facilitate login, and backwards-compatible APIs. You can always confirm the location of your organization by viewing your organization's settings page. +## Using Data Storage Location APIs + +To ensure that your API requests are only processed within your selected data storage location, use the region-specific domain: + +| **Data Storage Location** | **API domain** | +| ----------------------------- | -------------- | +| United States of America (US) | us.sentry.io | +| European Union (EU) | de.sentry.io | + +For [data stored in the US](#data-stored-in-us), your API domain should be `sentry.io`. + ## Switching Data Storage Locations for Existing Organizations ### SaaS