Using environment clients

Environment clients are the “connection” between Enterspeed and your front-end and, as the name suggests, it is also tied up to one of your environments. Moreover, environment clients also have domains attached to them, which makes it possible to filter your data based on the host names attached to the domain name. However, unlike environments, you can have as many domains attached to your environment client as you wish, but you will need at least one. You can also choose to have a single environment client per domain if you have multiple sites, for instance for separation of concern.

​

Creating an environment

Click the Settings-tab and then click the Environment settings-tab in the sidemenu. Scroll down to Domains and click the Create-button. Give your Environment client a name and select an environment. Next, select the domains you wish to add to the environment client and then click Save changes. Once the environment client has been created an API key will be available. If needed the key can be regenerated by clicking the three dots next to the environment client (Settings) and selecting Regenerate API Key.

​

API Scopes

API scopes allow you to control which Enterspeed APIs your environment client can access, following the principle of least privilege. This is particularly useful when integrating with AI agents or third-party services where you want to limit access to only the necessary endpoints.

​

Default Scopes

When creating a new environment client, it automatically receives these default scopes:

• Delivery API - Access to content delivery endpoints
• Query API - Access schema-transformed and auto indexed data
• Routes API - Access to route management and execution

​

Available Scopes

​

Scope Presets

For convenience, the Management App provides several preset configurations:

• Standard - Delivery + Routes + Query (default for regular applications)
• AI Assistant - Query + MCP Server — Full data access for AI agents
• Custom - Manually select specific scopes

​

Managing Scopes

You can configure scopes when creating or updating an environment client through the Management App. Existing environment clients without explicit scopes will continue to work with the default scope configuration, ensuring backward compatibility.

​

Index-Level Scopes (Advanced)

Beyond controlling which APIs your environment client can access, you can also configure index-level scopes within the Query API to restrict access to specific data. This provides fine-grained control over exactly what content an AI agent or integration can access.

​

Schema indices

When your environment client has Query API access, you can optionally restrict it to specific schema indices:

• All indices (default) - Access to all deployed index schemas
• Specific indices - Access only to selected schemas (e.g., blogpost, product)
• Wildcard patterns - Access to schemas matching patterns (e.g., blog* matches blogpost, blogpage, etc.)

Example use cases:

• AI agent for blog content: Restrict to blogpost and blogpage indices only
• Product recommendation system: Restrict to product and category indices only
• Content migration tool: Use cms* pattern for all CMS-related schemas

​

Auto indices

You can also optionally restrict Query API access to specific auto-indexed source group and entity type combinations:

• All sources (default) - Access to all auto-indexed source entities
• Specific combinations - Access only to selected source group + entity type pairs (e.g., cms:page, shop:product)
• Wildcard patterns - Access to all entity types within a source group (e.g., cms:*)

Format: Index scopes use the pattern sourceGroup:entityType Example configurations:

• CMS content only: cms:page, cms:article, cms:blogpost
• E-commerce data: shop:product, shop:category, shop:inventory
• All CMS content: cms:*

​

Index Scope Behaviour

This two-layer approach provides maximum flexibility:

1. Component scopes control which APIs can be accessed
2. Index scopes control which specific data within those APIs can be accessed