> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/configuration-service-tutorial.md).

# Configuration Service Tutorial

The Configuration Service is a general store for tenant-specific information. It allows you to manage various settings and configurations that control how your Emporix e-commerce system operates.

## Types of configurations

The Configuration Service manages three types of configurations:

* **Tenant configurations** — Applicable to all services across the tenant. Use tenant configurations for settings that apply across your entire tenant, such as:
  * Default languages, currencies, and countries
  * Customer redirect URLs
  * Email notification settings
  * Tax and packaging configurations
  * Storefront settings
* **Client configurations** — Associated with particular services. Use client configurations for service-specific settings, such as indexing configurations.
* **Global configurations** — Read-only configurations associated with all services across all tenants.

### Configuration structure

**Tenant configurations**:

```json
{
  "key": "configuration_key",
  "secured": false,
  "value": "configuration_value",
  "version": 1
}
```

* `key` — The configuration key identifier
* `secured` — Whether the configuration is secured (boolean)
* `value` — The configuration value (can be a string, number, boolean, object, or array)
* `version` — The version number of the configuration (incremented on each update)

**Client configurations**:

```json
{
  "_id": "client_key_identifier",
  "client": "client_name",
  "key": "configuration_key",
  "value": "configuration_value"
}
```

* `_id` — Unique identifier combining client and key
* `client` — The client/service name
* `key` — The configuration key identifier
* `value` — The configuration value (can be a string, number, boolean, object, or array)

## Common configuration keys

The Configuration Service supports various configuration keys for different purposes. Many of these keys (although not all) can also be managed in **Management Dashboard** -> **Settings** -> **System Preferences**. The **MD Setting** column indicates whether a key is available there. For full descriptions, possible values, and default values of keys marked **yes**, see [System Preferences](/ce/management-dashboard/settings/system-preferences.md).

| Configuration Key                                          | Description                                                                                                 | MD Setting |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------- |
| `allowAnonymousCheckoutWithExistingCustomerEmail`          | Whether anonymous checkout is allowed when the customer email already exists                                | yes        |
| `allowToSkipRelatedProductsValidation`                     | Whether related products validation can be skipped                                                          | yes        |
| `approval.default_expiryDays`                              | Default number of days until an approval expires                                                            | yes        |
| `approval.enableQuoteApprovalProcess`                      | Whether the quote approval workflow is enabled                                                              | yes        |
| `cartItemValidationSkipCurrency`                           | Whether `currency` is optional when adding items to cart                                                    | yes        |
| `cartItemValidationSkipEffectiveAmount`                    | Whether `effectiveAmount` is optional when adding items to cart                                             | yes        |
| `cartItemValidationSkipExistingItemsValidationOnAddToCart` | Whether to skip validation for existing cart items when adding a new item                                   | yes        |
| `cartItemValidationSkipOriginalAmount`                     | Whether `originalAmount` is optional when adding items to cart                                              | yes        |
| `companyContactPropagation`                                | How company contact assignments are propagated in a company hierarchy (`DOWNWARD`, `UPWARD`, or `DISABLED`) | yes        |
| `couponPermanentDelete`                                    | Whether deleted coupons are permanently removed from the database instead of being flagged as deleted       | yes        |
| `cust.notification.email.from`                             | Email address used as the sender for customer notifications                                                 | no         |
| `customer.changeemail.redirecturl`                         | URL to redirect customers when changing their email address                                                 | no         |
| `customer.deletion.redirecturl`                            | URL to redirect customers after account deletion                                                            | no         |
| `customer.passwordreset.redirecturl`                       | URL of the page for resetting the customer's password                                                       | yes        |
| `customerActiveOnCreation`                                 | Whether newly created customers are set as active by default                                                | yes        |
| `customerOnHoldOnCreation`                                 | Whether newly created customers are set on hold by default                                                  | yes        |
| `enableCouponCodeCaseSensitivity`                          | Whether coupon codes can be saved in both upper and lower case                                              | yes        |
| `enableExternalPrices`                                     | Whether external price and product sourcing is enabled at cart level                                        | yes        |
| `enableLegalEntityAddressFallbackInCart`                   | Whether to fall back to the legal entity address in cart when no address is provided                        | yes        |
| `enableOrderAddressPropagation`                            | Whether the address from an order is automatically saved to the customer profile                            | yes        |
| `enableProductCategoryAssignmentValidation`                | Whether to validate that a product exists before assigning it to a category                                 | yes        |
| `enableRecreationOfDeletedCustomer`                        | Whether a customer with the same customer number can be created after deletion                              | no         |
| `enableSyncBetweenRestrictionsAndSiteCodes`                | Whether entity restrictions are synchronized with defined site codes                                        | yes        |
| `invoiceSettings`                                          | Invoice generation thresholds and statuses                                                                  | no         |
| `maxNumberOfCouponsPerCart`                                | Maximum number of coupons that can be applied per cart                                                      | yes        |
| `openAiApiToken`                                           | OpenAI API token used to connect Emporix AI features to OpenAI                                              | yes        |
| `packagingConf`                                            | Packaging groups and position options                                                                       | no         |
| `populateProductDetailsOnAddToCart`                        | Whether product details are automatically populated when adding items to cart                               | yes        |
| `project_country`                                          | Default country for your tenant                                                                             | no         |
| `project_curr`                                             | Default currencies for your tenant                                                                          | no         |
| `project_lang`                                             | Default languages for your tenant                                                                           | no         |
| `restrictions`                                             | List of restrictions applied to site-aware entities                                                         | yes        |
| `signUp.enableAccountCreationEmailConfirmation`            | Whether welcome emails are sent when new customer accounts are created                                      | yes        |
| `ssoCustomerAutoprovisioningDisabled`                      | Whether automatic customer creation during SSO token exchange is disabled                                   | yes        |
| `ssoCustomerIdentifierField`                               | Field used to identify customers during token exchange (`EMAIL` or `SUBJECT`)                               | yes        |
| `storefront.host`                                          | Hostname for your storefront                                                                                | no         |
| `storefront.htmlPage`                                      | Default HTML page for your storefront                                                                       | no         |
| `taxConfiguration`                                         | Tax classes and rates configuration                                                                         | no         |
| `unitConf`                                                 | Unit conversion configurations                                                                              | no         |

## Managing tenant configurations

### How to retrieve all tenant configurations

To retrieve a list of all tenant configurations, send a request to the [Retrieving configurations](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/tenant-configurations#get-configuration-tenant-configurations) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

You can also filter configurations by specific keys using the `keys` query parameter, for example:

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations?keys=project_lang' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

### How to retrieve a specific tenant configuration

To retrieve a specific tenant configuration by its key, send a request to the [Retrieving a configuration](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/tenant-configurations#get-configuration-tenant-configurations-propertykey) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/{propertyKey}' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

**Example:** Retrieving the language configuration

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/project_lang' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

The example response looks like:

```json
{
  "key": "project_lang",
  "secured": false,
  "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true}]",
  "version": 2
}
```

### How to create tenant configurations

To create new tenant configurations, send a request to the [Creating configurations](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/tenant-configurations#post-configuration-tenant-configurations) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

**Example:** Creating multiple configurations at once

```bash
curl -L 
  --request POST 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '[
    {
      "key": "project_country",
      "secured": false,
      "value": "DE",
      "version": 1
    },
    {
      "key": "project_lang",
      "secured": false,
      "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true},{\"id\":\"de\",\"label\":\"German\",\"default\":false,\"required\":false}]",
      "version": 1
    }
  ]'
```

**Example:** Creating invoice settings configuration

```bash
curl -L 
  --request POST 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '[
    {
      "key": "invoiceSettings",
      "secured": false,
      "value": {
        "threshold": "24",
        "status": "CREATED,CONFIRMED",
        "extendedOrderStatus": "70,75,76"
      },
      "version": 1
    }
  ]'
```

**Example:** Enabling recreation of deleted customers

```bash
curl -L 
  --request POST 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '[
    {
      "key": "enableRecreationOfDeletedCustomer",
      "secured": false,
      "value": true,
      "version": 1
    }
  ]'
```

{% hint style="warning" %}
**Enabling recreation of deleted customers**

By default, for security reasons, it is not possible to recreate a customer that was previously deleted. During customer creation, the Customer Service rejects requests that use a `customerNumber` already assigned to a deleted customer profile.

To allow recreation of previously deleted customers with the same customer number, create the `enableRecreationOfDeletedCustomer` tenant configuration and set its value to `true`, as shown in the preceding example.
{% endhint %}

{% hint style="warning" %}
When creating configurations, make sure the `version` field is set to `1` for new configurations. The version number is incremented automatically when you update the configuration.
{% endhint %}

### How to update a tenant configuration

To update an existing tenant configuration, send a request to the [Updating a configuration](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/tenant-configurations#put-configuration-tenant-configurations-propertykey) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

**Example:** Updating the country configuration

```bash
curl -L 
  --request PUT 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/project_country' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '{
    "key": "project_country",
    "secured": false,
    "value": "AT",
    "version": 1
  }'
```

{% hint style="warning" %}
The `key` in the request body must match the `propertyKey` in the URL path. Also, make sure to include the current `version` number from the existing configuration to avoid conflicts.
{% endhint %}

**Example:** Updating customer redirect URLs

```bash
curl -L 
  --request PUT 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/customer.deletion.redirecturl' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '{
    "key": "customer.deletion.redirecturl",
    "secured": false,
    "value": "https://tenant.com/custDelete?token=",
    "version": 1
  }'
```

**Example:** Updating tax configuration

```bash
curl -L 
  --request PUT 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/taxConfiguration' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '{
    "key": "taxConfiguration",
    "secured": false,
    "value": {
      "taxClassOrder": ["FULL", "HALF", "ZERO"],
      "taxClasses": {
        "FULL": 19,
        "HALF": 7,
        "ZERO": 0
      }
    },
    "version": 1
  }'
```

**Example:** Updating packaging configuration

```bash
curl -L 
  --request PUT 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/packagingConf' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '{
    "key": "packagingConf",
    "secured": false,
    "value": {
      "packagingGroupOptions": [
        "1_cooling_product",
        "2_standard",
        "3_fragile"
      ],
      "packagingPositionOptions": [
        "1_bottom_robust",
        "2_bottom_insensitive",
        "3_middle_standard",
        "4_top_sensitive"
      ]
    },
    "version": 1
  }'
```

**Example:** Updating storefront settings

```bash
curl -L 
  --request PUT 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/storefront.host' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '{
    "key": "storefront.host",
    "secured": false,
    "value": "tenant.com",
    "version": 1
  }'
```

**Example:** Updating email notification settings

```bash
curl -L 
  --request PUT 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/cust.notification.email.from' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '{
    "key": "cust.notification.email.from",
    "secured": false,
    "value": "example_email@emporix.com",
    "version": 1
  }'
```

### How to delete a tenant configuration

To delete a tenant configuration, send a request to the [Deleting a configuration](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/tenant-configurations#delete-configuration-tenant-configurations-propertykey) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --request DELETE 
  --url 'https://api.emporix.io/configuration/{tenant}/configurations/{propertyKey}' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}'
```

## Managing client configurations

Client configurations are service-specific settings that apply to particular services rather than the entire tenant.

### How to retrieve available clients

To retrieve a list of available clients for your tenant, send a request to the [Retrieving clients](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/client-configurations#get-configuration-tenant-clients) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/clients' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

The example response looks like:

```json
[
  "saas-ag.caas-indexing-service-client"
]
```

### How to retrieve client configurations

To retrieve all configurations for a specific client, send a request to the [Retrieving client configurations](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/client-configurations#get-configuration-tenant-clients-client-configurations) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/{client}/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

**Example:** Retrieving indexing service client configurations

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/saas-ag.caas-indexing-service-client/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

The example response looks like:

```json
[
  {
    "_id": "saas-ag.caas-indexing-service-client_algolia_activation",
    "client": "saas-ag.caas-indexing-service-client",
    "key": "algolia_activation",
    "value": true
  },
  {
    "_id": "saas-ag.caas-indexing-service-client_indexing_configuration",
    "client": "saas-ag.caas-indexing-service-client",
    "key": "indexing_configuration",
    "value": {
      "activePublishedProductIndexing": true,
      "activeNonPublishedProductIndexing": true
    }
  }
]
```

You can also filter client configurations by specific keys using the `keys` query parameter:

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/{client}/configurations?keys=algolia_activation' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

### How to retrieve a specific client configuration

To retrieve a specific client configuration by its key, send a request to the [Retrieving a client configuration](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/client-configurations#get-configuration-tenant-clients-client-configurations-propertykey) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/{client}/configurations/{propertyKey}' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

**Example:** Retrieving a specific indexing configuration

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/saas-ag.caas-indexing-service-client/configurations/indexing_configuration' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

The example response looks like:

```json
{
  "_id": "saas-ag.caas-indexing-service-client_indexing_configuration",
  "client": "saas-ag.caas-indexing-service-client",
  "key": "indexing_configuration",
  "value": {
    "activePublishedProductIndexing": true,
    "activeNonPublishedProductIndexing": true
  }
}
```

### How to create client configurations

To create new client configurations, send a request to the [Creating client configurations](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/client-configurations#post-configuration-tenant-clients-client-configurations) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --request POST 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/{client}/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '[
    {
      "client": "test_client",
      "key": "test_key",
      "value": true
    }
  ]'
```

**Example:** Creating a client configuration

```bash
curl -L 
  --request POST 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/client_one/configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '[
    {
      "client": "example_client",
      "key": "example_key",
      "value": true
    }
  ]'
```

The response looks like:

```json
{
  "_id": "client_one_example_key",
  "client": "client_one",
  "key": "example_key",
  "value": true,
  "description": null,
  "schemaUrl": null,
  "version": 0,
  "secured": false,
  "restricted": false,
  "readOnly": false
}
```

### How to update a client configuration

To update an existing client configuration, send a request to the [Updating a client configuration](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/client-configurations#put-configuration-tenant-clients-client-configurations-propertykey) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --request PUT 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/{client}/configurations/{propertyKey}' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Content-Type: application/json' 
  --data '{
    "client": "example_client",
    "key": "example_key",
    "value": false
  }'
```

### How to delete a client configuration

To delete a client configuration, send a request to the [Deleting a client configuration](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/client-configurations#delete-configuration-tenant-clients-client-configurations-propertykey) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --request DELETE 
  --url 'https://api.emporix.io/configuration/{tenant}/clients/{client}/configurations/{propertyKey}' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}'
```

## Retrieving global configurations

Global configurations are read-only configurations that are associated with all services across all tenants. These configurations provide default values and system-wide settings.

### How to retrieve global configurations

To retrieve a list of global configurations, send a request to the [Retrieving global configurations](https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/api-reference/global-configurations#get-configuration-tenant-global-configurations) endpoint.

{% hint style="success" %}
To test the endpoint, open the API reference or check the example of a curl request.
{% endhint %}

{% content-ref url="/pages/tdSQ3AsLz7TjdDcECwNM" %}
[API Reference](/api-references/api-guides/configuration/configuration-service/api-reference.md)
{% endcontent-ref %}

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/global-configurations' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

You can also filter global configurations by specific keys using the `keys` query parameter:

```bash
curl -L 
  --url 'https://api.emporix.io/configuration/{tenant}/global-configurations?keys=project_lang,project_curr' 
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' 
  --header 'Accept: */*'
```

{% hint style="info" %}
Global configurations are read-only and cannot be created, updated, or deleted through the API. They are managed by the Emporix system and provide default values that can be overridden by tenant configurations.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.emporix.io/api-references/api-guides/configuration/configuration-service/configuration-service-tutorial.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.