Contentstack 2.4.1__tar.gz → 2.6.0__tar.gz

{contentstack-2.4.1 → contentstack-2.6.0}/Contentstack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Contentstack
-Version: 2.4.1
+Version: 2.6.0
 Summary: Contentstack is a headless CMS with an API-first approach.
 Home-page: https://github.com/contentstack/contentstack-python
 Author: Contentstack
@@ -188,7 +188,7 @@ Read through to understand how to use the Sync API with Contentstack Python SDK.
 
 ### The MIT License (MIT)
 
-Copyright © 2012-2025 [Contentstack](https://www.contentstack.com/). All Rights Reserved
+Copyright © 2012-2026 [Contentstack](https://www.contentstack.com/). All Rights Reserved
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the

{contentstack-2.4.1 → contentstack-2.6.0}/Contentstack.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ contentstack/basequery.py
 contentstack/contenttype.py
 contentstack/controller.py
 contentstack/deep_merge_lp.py
+contentstack/endpoint.py
 contentstack/entry.py
 contentstack/entryqueryable.py
 contentstack/error_messages.py
@@ -21,13 +22,16 @@ contentstack/globalfields.py
 contentstack/https_connection.py
 contentstack/image_transform.py
 contentstack/query.py
+contentstack/region_refresh.py
 contentstack/stack.py
 contentstack/taxonomy.py
 contentstack/utility.py
 contentstack/variants.py
 tests/test_assets.py
+tests/test_basequery.py
 tests/test_early_fetch.py
 tests/test_early_find.py
+tests/test_endpoint.py
 tests/test_entry.py
 tests/test_global_fields.py
 tests/test_live_preview.py

{contentstack-2.4.1 → contentstack-2.6.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2012 - 2025 Contentstack. All rights reserved.
+Copyright (c) 2012 - 2026 Contentstack. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{contentstack-2.4.1 → contentstack-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Contentstack
-Version: 2.4.1
+Version: 2.6.0
 Summary: Contentstack is a headless CMS with an API-first approach.
 Home-page: https://github.com/contentstack/contentstack-python
 Author: Contentstack
@@ -188,7 +188,7 @@ Read through to understand how to use the Sync API with Contentstack Python SDK.
 
 ### The MIT License (MIT)
 
-Copyright © 2012-2025 [Contentstack](https://www.contentstack.com/). All Rights Reserved
+Copyright © 2012-2026 [Contentstack](https://www.contentstack.com/). All Rights Reserved
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the

{contentstack-2.4.1 → contentstack-2.6.0}/README.md

@@ -152,7 +152,7 @@ Read through to understand how to use the Sync API with Contentstack Python SDK.
 
 ### The MIT License (MIT)
 
-Copyright © 2012-2025 [Contentstack](https://www.contentstack.com/). All Rights Reserved
+Copyright © 2012-2026 [Contentstack](https://www.contentstack.com/). All Rights Reserved
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the

contentstack-2.6.0/contentstack/__init__.py

@@ -0,0 +1,49 @@
+"""
+The __init__.py files are required to make Python treat the directories as containing
+packages; this is done to prevent directories with a common name, such as string,
+from unintentionally hiding valid modules that occur later on the module search path
+"""
+from .entry import Entry
+from .asset import Asset
+from .contenttype import ContentType
+from .endpoint import Endpoint
+from .https_connection import HTTPSConnection
+from contentstack.stack import Stack
+from .utility import Utils
+from .region_refresh import refresh_regions
+
+__all__ = (
+"Entry",
+"Asset",
+"ContentType",
+"Endpoint",
+"HTTPSConnection",
+"Stack",
+"Utils",
+"refresh_regions",
+)
+
+
+def get_contentstack_endpoint(region='us', service='', omit_https=False):
+    """
+    Resolve a Contentstack service endpoint URL for a given region.
+
+    Proxy to :class:`Endpoint.get_contentstack_endpoint` for convenience —
+    mirrors ``Contentstack::getContentstackEndpoint()`` in the PHP SDK.
+
+    :param region: Region ID or alias ('us', 'eu', 'azure-na', 'gcp-eu', ...).
+    :param service: Service key ('contentDelivery', 'contentManagement', ...).
+                    When empty, returns a dict of all endpoints for the region.
+    :param omit_https: When True, strips 'https://' from the returned URL(s).
+    :returns: str when service is provided, dict[str,str] otherwise.
+    """
+    return Endpoint.get_contentstack_endpoint(region, service, omit_https)
+
+__title__ = 'contentstack-delivery-python'
+__author__ = 'contentstack'
+__status__ = 'debug'
+__version__ = 'v2.6.0'
+__endpoint__ = 'cdn.contentstack.io'
+__email__ = 'support@contentstack.com'
+__developer_email__ = 'mobile@contentstack.com'
+__license__ = "MIT"

{contentstack-2.4.1 → contentstack-2.6.0}/contentstack/asset.py

@@ -17,6 +17,7 @@ class Asset:
         self.__uid = uid
         if self.__uid is None or self.__uid.strip() == 0:
             raise KeyError(ErrorMessages.INVALID_UID)
+        self.uid = uid
         self.base_url = f'{self.http_instance.endpoint}/assets/{self.__uid}'
         if 'environment' in self.http_instance.headers:
             self.asset_params['environment'] = self.http_instance.headers['environment']
@@ -117,6 +118,35 @@ class Asset:
         self.asset_params['include_fallback'] = "true"
         return self
 
+    def asset_fields(self, *field_names):
+        r"""Include specific asset fields in the response.
+        Supported values: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
+        Pass one or more field names. Can be called multiple times to add more fields.
+
+        :param field_names: One or more asset field names (user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
+        :return: `Asset`, so we can chain the call
+        ----------------------------
+        Example::
+            >>> import contentstack
+            >>> stack = contentstack.Stack('api_key', 'delivery_token', 'environment')
+            >>> asset = stack.asset(uid='asset_uid')
+            >>> result = asset.asset_fields('user_defined_fields', 'visual_markups').fetch()
+        ----------------------------
+        """
+        if field_names:
+            values = []
+            for name in field_names:
+                if isinstance(name, (list, tuple)):
+                    values.extend(str(v) for v in name)
+                else:
+                    values.append(str(name))
+            if values:
+                existing = self.asset_params.get('asset_fields[]', [])
+                if not isinstance(existing, list):
+                    existing = [existing]
+                self.asset_params['asset_fields[]'] = existing + values
+        return self
+
     def fetch(self):
         r"""This call fetches the latest version of a specific asset of a particular stack.
         :return: json response of asset

{contentstack-2.4.1 → contentstack-2.6.0}/contentstack/assetquery.py

@@ -157,6 +157,36 @@ class AssetQuery(BaseQuery):
         self.asset_query_params['locale'] = locale
         return self
 
+    def asset_fields(self, *field_names):
+        r"""Include specific asset fields in the response.
+        Supported values: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
+        Pass one or more field names. Can be called multiple times to add more fields.
+
+        :param field_names: One or more asset field names (user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
+        :return: AssetQuery: so we can chain the call
+
+        -----------------------------
+        [Example]:
+
+            >>> import contentstack
+            >>> stack = contentstack.Stack('api_key', 'delivery_token', 'environment')
+            >>> result = stack.asset_query().asset_fields('user_defined_fields', 'visual_markups').find()
+        ------------------------------
+        """
+        if field_names:
+            values = []
+            for name in field_names:
+                if isinstance(name, (list, tuple)):
+                    values.extend(str(v) for v in name)
+                else:
+                    values.append(str(name))
+            if values:
+                existing = self.asset_query_params.get('asset_fields[]', [])
+                if not isinstance(existing, list):
+                    existing = [existing]
+                self.asset_query_params['asset_fields[]'] = existing + values
+        return self
+
     def find(self):
         r"""This call fetches the list of all the assets of a particular stack.
         It also returns the content of each asset in JSON format.

{contentstack-2.4.1 → contentstack-2.6.0}/contentstack/contenttype.py

@@ -7,6 +7,7 @@ content type.
 
 # ************* Module ContentType **************
 # Your code has been rated at 10.00/10 by pylint
+from __future__ import annotations
 import json
 import logging
 from urllib import parse

contentstack-2.6.0/contentstack/endpoint.py

@@ -0,0 +1,180 @@
+"""
+Endpoint — Contentstack region-to-URL resolver.
+
+Resolves Contentstack service endpoint URLs for any supported region.
+Region data is loaded from contentstack/assets/regions.json (bundled) and
+cached in-memory for the lifetime of the process. When the bundled file is
+absent the class attempts a live download from the Contentstack CDN so the
+SDK continues to work even when the file was not created during installation.
+"""
+
+import json
+import os
+import re
+
+REGIONS_URL = 'https://artifacts.contentstack.com/regions.json'
+
+
+class Endpoint:
+    """
+    Resolves Contentstack service endpoint URLs for any supported region.
+
+    Usage::
+
+        from contentstack.endpoint import Endpoint
+
+        # Single service URL
+        url = Endpoint.get_contentstack_endpoint('eu', 'contentDelivery')
+        # 'https://eu-cdn.contentstack.com'
+
+        # All services for a region
+        endpoints = Endpoint.get_contentstack_endpoint('azure-na')
+        # {'contentDelivery': 'https://...', 'contentManagement': 'https://...', ...}
+
+        # Strip scheme (useful when setting host directly)
+        host = Endpoint.get_contentstack_endpoint('gcp-eu', 'contentDelivery', omit_https=True)
+        # 'gcp-eu-cdn.contentstack.com'
+    """
+
+    _regions_data = None  # in-memory cache — shared across all instances
+
+    @staticmethod
+    def get_contentstack_endpoint(region='us', service='', omit_https=False):
+        """
+        Resolve a Contentstack service endpoint URL for a given region.
+
+        :param region: Region ID or alias ('us', 'eu', 'azure-na', 'gcp-eu', etc.).
+                       Defaults to 'us' (AWS North America).
+        :param service: Service key ('contentDelivery', 'contentManagement', ...).
+                        When empty, returns a dict of all endpoints for the region.
+        :param omit_https: When True, strips 'https://' prefix from returned URL(s).
+        :returns: str when service is provided, dict[str,str] otherwise.
+        :raises ValueError: When region is empty, unknown, or service is not found.
+        :raises RuntimeError: When regions.json cannot be read or parsed.
+        """
+        if not region:
+            raise ValueError('Empty region provided. Please put valid region.')
+
+        data = Endpoint._load_regions()
+        normalized = region.strip().lower()
+        region_row = Endpoint._find_region(data['regions'], normalized)
+
+        if region_row is None:
+            raise ValueError(f'Invalid region: {region}')
+
+        if service:
+            if service not in region_row['endpoints']:
+                raise ValueError(
+                    f'Service "{service}" not found for region "{region_row["id"]}"'
+                )
+            url = region_row['endpoints'][service]
+            return Endpoint._strip_https(url) if omit_https else url
+
+        endpoints = region_row['endpoints']
+        if omit_https:
+            return {k: Endpoint._strip_https(v) for k, v in endpoints.items()}
+        return dict(endpoints)
+
+    @staticmethod
+    def _load_regions():
+        """
+        Load and cache regions.json.
+
+        Resolution order:
+          1. In-memory static cache (zero I/O after first call)
+          2. contentstack/assets/regions.json on disk (written by download script)
+          3. Live download from artifacts.contentstack.com (fallback)
+        """
+        if Endpoint._regions_data is not None:
+            return Endpoint._regions_data
+
+        assets_dir = os.path.join(os.path.dirname(__file__), 'assets')
+        path = os.path.join(assets_dir, 'regions.json')
+
+        if not os.path.exists(path):
+            Endpoint._download_and_save(path)
+
+        if not os.path.exists(path):
+            raise RuntimeError(
+                'contentstack: regions.json not found and could not be downloaded. '
+                'Run "python scripts/download_regions.py" and ensure network access.'
+            )
+
+        try:
+            with open(path, 'r', encoding='utf-8') as f:
+                decoded = json.load(f)
+        except (OSError, json.JSONDecodeError) as exc:
+            raise RuntimeError(
+                f'contentstack: Could not read or parse regions.json: {exc}. '
+                'Run "python scripts/download_regions.py" to re-download it.'
+            ) from exc
+
+        if not isinstance(decoded, dict) or 'regions' not in decoded:
+            raise RuntimeError(
+                'contentstack: regions.json is corrupt. '
+                'Run "python scripts/download_regions.py" to re-download it.'
+            )
+
+        Endpoint._regions_data = decoded
+        return Endpoint._regions_data
+
+    @staticmethod
+    def _download_and_save(dest):
+        """
+        Download regions.json from the Contentstack CDN and save to disk.
+        Uses the requests library (already an SDK dependency).
+        Silent on failure — the caller decides whether a missing file is fatal.
+
+        :param dest: Absolute path to write the file to.
+        """
+        os.makedirs(os.path.dirname(dest), exist_ok=True)
+
+        try:
+            import requests
+            response = requests.get(REGIONS_URL, timeout=30)
+            response.raise_for_status()
+            data = response.text
+        except Exception:  # noqa: BLE001
+            return
+
+        try:
+            decoded = json.loads(data)
+        except json.JSONDecodeError:
+            return
+
+        if isinstance(decoded, dict) and 'regions' in decoded:
+            try:
+                with open(dest, 'w', encoding='utf-8') as f:
+                    f.write(data)
+            except OSError:
+                pass
+
+    @staticmethod
+    def _find_region(regions, input_str):
+        """
+        Find a region entry by its id or any alias (case-insensitive).
+
+        Two-pass: exact id match first, then alias[] scan — mirrors PHP implementation.
+
+        :param regions: list of region dicts from regions.json
+        :param input_str: already-lowercased input
+        :returns: region dict or None
+        """
+        for row in regions:
+            if row['id'] == input_str:
+                return row
+        for row in regions:
+            for alias in row.get('alias', []):
+                if alias.lower() == input_str:
+                    return row
+        return None
+
+    @staticmethod
+    def _strip_https(url):
+        """Strip the https:// (or http://) scheme from a URL string."""
+        return re.sub(r'^https?://', '', url)
+
+    @staticmethod
+    def reset_cache():
+        """Reset the internal region cache. Intended for testing only."""
+        Endpoint._regions_data = None

{contentstack-2.4.1 → contentstack-2.6.0}/contentstack/entry.py

@@ -3,6 +3,7 @@ The Get a single entry request fetches a particular entry of a content type.
 API Reference: https://www.contentstack.com/docs/developers/apis/content-delivery-api/#single-entry
 """
 #min-similarity-lines=10
+from __future__ import annotations
 import logging
 from urllib import parse
 from contentstack.error_messages import ErrorMessages
@@ -54,6 +55,25 @@ class Entry(EntryQueryable):
         self.http_instance.headers['environment'] = environment
         return self
 
+    def remove_environment(self):
+        """Removes environment from the request headers
+        :return: Entry, so we can chain the call
+        -------------------------------
+        Example::
+
+            >>> import contentstack
+            >>> stack = contentstack.Stack('api_key', 'delivery_token', 'environment')
+            >>> content_type = stack.content_type('content_type_uid')
+            >>> entry = content_type.entry(uid='entry_uid')
+            >>> entry = entry.environment('test')
+            >>> entry = entry.remove_environment()
+            >>> result = entry.fetch()
+        -------------------------------
+        """
+        if 'environment' in self.http_instance.headers:
+            self.http_instance.headers.pop('environment')
+        return self
+
     def version(self, version):
         """When no version is specified, it returns the latest version
         To retrieve a specific version, specify the version number under this parameter.
@@ -96,6 +116,9 @@ class Entry(EntryQueryable):
         """
         if None in (key, value) and not isinstance(key, str):
             raise ValueError(ErrorMessages.INVALID_KEY_VALUE_ARGS)
+        # Convert non-string values to strings
+        if not isinstance(value, str):
+            value = str(value)
         self.entry_param[key] = value
         return self
 
@@ -154,6 +177,26 @@ class Entry(EntryQueryable):
         self.entry_param['include_embedded_items[]'] = "BASE"
         return self
 
+    def asset_fields(self, *field_names):
+        """Include specific asset fields in the response.
+        Supported values: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
+        Pass one or more field names. Can be called multiple times to add more fields.
+
+        :param field_names: One or more asset field names (user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
+        :return: Entry, so we can chain the call
+        ----------------------------
+        Example::
+
+            >>> import contentstack
+            >>> stack = contentstack.Stack('api_key', 'delivery_token', 'environment')
+            >>> content_type = stack.content_type('content_type_uid')
+            >>> entry = content_type.entry(uid='entry_uid')
+            >>> entry = entry.asset_fields('user_defined_fields', 'visual_markups')
+            >>> result = entry.fetch()
+        ----------------------------
+        """
+        return super().asset_fields(*field_names)
+
     def __get_base_url(self, endpoint=''):
         if endpoint is not None and endpoint.strip(): # .strip() removes leading/trailing whitespace
             self.http_instance.endpoint = endpoint

{contentstack-2.4.1 → contentstack-2.6.0}/contentstack/entryqueryable.py

@@ -167,6 +167,45 @@ class EntryQueryable:
         self.entry_queryable_param['include_metadata'] = 'true'
         return self
 
+    def asset_fields(self, *field_names):
+        """
+        Include specific asset fields in the response.
+        Supported values: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
+        Pass one or more field names. Can be called multiple times to add more fields.
+
+        :param field_names: One or more asset field names (user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
+        :return: self: so you can chain this call.
+
+        Example (Query):
+            >>> import contentstack
+            >>> stack = contentstack.Stack('api_key', 'delivery_token', 'environment')
+            >>> content_type = stack.content_type('content_type_uid')
+            >>> query = content_type.query()
+            >>> query = query.asset_fields('user_defined_fields', 'visual_markups')
+            >>> result = query.find()
+
+        Example (Entry):
+            >>> import contentstack
+            >>> stack = contentstack.Stack('api_key', 'delivery_token', 'environment')
+            >>> content_type = stack.content_type('content_type_uid')
+            >>> entry = content_type.entry('entry_uid')
+            >>> entry = entry.asset_fields('user_defined_fields', 'visual_markups')
+            >>> result = entry.fetch()
+        """
+        if field_names:
+            values = []
+            for name in field_names:
+                if isinstance(name, (list, tuple)):
+                    values.extend(str(v) for v in name)
+                else:
+                    values.append(str(name))
+            if values:
+                existing = self.entry_queryable_param.get('asset_fields[]', [])
+                if not isinstance(existing, list):
+                    existing = [existing]
+                self.entry_queryable_param['asset_fields[]'] = existing + values
+        return self
+
     def add_param(self, key: str, value: str):
         """
         This method adds key and value to an Entry.

contentstack-2.6.0/contentstack/region_refresh.py

@@ -0,0 +1,81 @@
+"""
+Utility to pull the latest regions.json from the Contentstack CDN and
+overwrite the bundled copy at contentstack/assets/regions.json.
+
+Exposed as a package-level function so tooling and CI pipelines can call it
+programmatically instead of invoking the script directly:
+
+    from contentstack import refresh_regions
+    refresh_regions()
+"""
+
+import json
+import os
+import sys
+import urllib.request
+
+_REGIONS_URL = "https://artifacts.contentstack.com/regions.json"
+_ASSET_PATH = os.path.join(os.path.dirname(__file__), "assets", "regions.json")
+
+
+def refresh_regions(
+    url: str = _REGIONS_URL,
+    dest: str = _ASSET_PATH,
+    *,
+    timeout: int = 30,
+    silent: bool = False,
+) -> dict:
+    """
+    Download the latest regions manifest from the Contentstack CDN and write
+    it to the bundled assets file so all consumers get the update.
+
+    @param url     - URL to fetch regions.json from (defaults to Contentstack CDN)
+    @param dest    - Destination file path (defaults to contentstack/assets/regions.json)
+    @param timeout - HTTP request timeout in seconds
+    @param silent  - Suppress progress output when True
+    @returns The parsed regions dict on success
+    @raises RuntimeError on download failure, invalid JSON, or unexpected schema
+    """
+    dest = os.path.normpath(dest)
+
+    if not silent:
+        print(f"Fetching {url} ...")
+
+    try:
+        with urllib.request.urlopen(url, timeout=timeout) as resp:
+            data = resp.read().decode("utf-8")
+    except Exception as exc:
+        raise RuntimeError(f"Could not download regions.json: {exc}") from exc
+
+    try:
+        decoded = json.loads(data)
+    except json.JSONDecodeError as exc:
+        raise RuntimeError(f"Downloaded content is not valid JSON: {exc}") from exc
+
+    if not isinstance(decoded, dict) or "regions" not in decoded:
+        raise RuntimeError("Downloaded JSON does not contain a 'regions' key.")
+
+    os.makedirs(os.path.dirname(dest), exist_ok=True)
+    with open(dest, "w", encoding="utf-8") as fh:
+        json.dump(decoded, fh, indent=2, ensure_ascii=False)
+        fh.write("\n")
+
+    region_count = len(decoded["regions"])
+    if not silent:
+        print(f"OK: Wrote {region_count} regions to {dest}")
+
+    return decoded
+
+
+def _cli_main() -> int:
+    """Entry point kept for backward compatibility with the scripts/ invocation."""
+    try:
+        refresh_regions()
+        return 0
+    except RuntimeError as exc:
+        print(f"ERROR: {exc}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(_cli_main())

{contentstack-2.4.1 → contentstack-2.6.0}/contentstack/stack.py

@@ -7,6 +7,7 @@ from contentstack.error_messages import ErrorMessages
 from contentstack.asset import Asset
 from contentstack.assetquery import AssetQuery
 from contentstack.contenttype import ContentType
+from contentstack.endpoint import Endpoint
 from contentstack.taxonomy import Taxonomy
 from contentstack.globalfields import GlobalField
 from contentstack.https_connection import HTTPSConnection
@@ -119,20 +120,15 @@ class Stack:
         if self.environment is None or self.environment == "":
             raise PermissionError(ErrorMessages.INVALID_ENVIRONMENT_TOKEN)
 
-        if self.region.value == 'eu' and self.host == DEFAULT_HOST:
-            self.host = 'eu-cdn.contentstack.com'
-        elif self.region.value == 'au' and self.host == DEFAULT_HOST:
-            self.host = 'au-cdn.contentstack.com'
-        elif self.region.value == 'azure-na' and self.host == DEFAULT_HOST:
-            self.host = 'azure-na-cdn.contentstack.com'
-        elif self.region.value == 'azure-eu' and self.host == DEFAULT_HOST:
-            self.host = 'azure-eu-cdn.contentstack.com'
-        elif self.region.value == 'gcp-na' and self.host == DEFAULT_HOST:
-            self.host = 'gcp-na-cdn.contentstack.com'
-        elif self.region.value == 'gcp-eu' and self.host == DEFAULT_HOST:
-            self.host = 'gcp-eu-cdn.contentstack.com'
-        elif self.region.value != 'us':
-            self.host = f'{self.region.value}-{DEFAULT_HOST}'
+        if self.host == DEFAULT_HOST:
+            try:
+                self.host = Endpoint.get_contentstack_endpoint(
+                    self.region.value, 'contentDelivery', omit_https=True)
+            except (ValueError, RuntimeError):
+                # Unknown/custom region — fall back to legacy pattern so
+                # code written before this feature was added continues to work.
+                if self.region.value != 'us':
+                    self.host = f'{self.region.value}-{DEFAULT_HOST}'
         self.endpoint = f'https://{self.host}/{self.version}'
 
     def _setup_headers(self):
@@ -365,8 +361,14 @@ class Stack:
     
     def _setup_live_preview(self):
         if self.live_preview and self.live_preview.get("enable"):
-            region_prefix = "" if self.region.value == "us" else f"{self.region.value}-"
-            self.live_preview["host"] = f"{region_prefix}rest-preview.contentstack.com"
+            if not self.live_preview.get("host"):
+                try:
+                    mgmt_host = Endpoint.get_contentstack_endpoint(
+                        self.region.value, 'contentManagement', omit_https=True)
+                except (ValueError, RuntimeError):
+                    region_prefix = "" if self.region.value == "us" else f"{self.region.value}-"
+                    mgmt_host = f"{region_prefix}api.contentstack.io"
+                self.live_preview["host"] = mgmt_host
 
             if self.live_preview.get("preview_token"):
                 self.headers["preview_token"] = self.live_preview["preview_token"]