feat: Add more context on data storage locations and API endpoints (#11652)

* Make links relative to the build
* Apply suggestions from code review

Fixes #11058
---------

Co-authored-by: Liza Mock <[email protected]>

Author: markstory

docs/api/index.mdx

@@ -21,3 +21,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.
+

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