docs(core): mark data store fallback temporary and list special cases

This commit is contained in:
Scott Idem
2026-05-01 14:31:19 -04:00
parent 19822c4eaf
commit 7cef6be54c
5 changed files with 29 additions and 3 deletions

View File

@@ -12,7 +12,9 @@ interface GetDataStoreV3Params {
/**
* Get a Data Store object by its human-friendly code (V3)
* Uses hierarchical fallback logic (Specific -> Account -> Global)
* Uses hierarchical fallback logic (Specific -> Account -> Global).
* TEMPORARY: the global fallback is a stopgap until the backend can
* serve account-scoped defaults via JWT-backed access only.
* Path: GET /v3/data_store/code/{code}
*/
export async function get_data_store({
@@ -36,8 +38,9 @@ export async function get_data_store({
const headers: key_val = {};
if (no_account_id) {
// Use the standard bypass header understood by get_object so the
// request can actually fall back to global defaults.
// TEMPORARY: keep this narrow global-default escape hatch until the
// backend can answer the data_store request with account-scoped JWT
// access only.
headers['x-no-account-id'] = 'Nothing to See Here';
}