For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configuration

Get all configurations

get

Retrieves all configurations of index providers. The returned response contains search and write keys.

Required scopes
This endpoint requires the following scopes:
  • : Needed to read an index provider configuration
Authorizations
OAuth2clientCredentialsRequired
Token URL:
Path parameters
tenantstring · min: 3 · max: 16Required

The tenant that the caller is acting upon.

Please note that this value is always lowercase.

Pattern: ^[a-z][a-z0-9]+$
Responses
200Success
application/json
searchKeystringOptional

API Key used for search purposes.

applicationIdstringOptional

Application id of an indexer provider.

indexNamestringOptional

Identifier of an index.

providerstring · enumRequired

Index provider name. Supported providers: ALGOLIA (https://www.algolia.com), BATTERY_INCLUDED (https://www.batteryincluded.io). Only one provider can be active per tenant at a time.

Possible values:
activebooleanOptional

Indicates if the configuration is active or not.

writeKeystringOptional

API key used for write purposes.

excludedMixinKeysstring[]Optional

Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the BATTERY_INCLUDED provider.

includedMixinPathsstring[]Optional

Optional allowlist of product mixin paths to include in indexing for the BATTERY_INCLUDED provider. Patterns are matched against full dot-notation paths rooted at the mixin key, for example class_EA673_toolsClassification.sk.OnlineIsService_P. * matches within a single path segment, ** matches across one or more path segments, and matching is case sensitive. If a matched path points to an object, the entire subtree under that object is included. When this field is absent or an empty list, path filtering is inactive and existing excludedMixinKeys behavior applies. includedMixinPaths and excludedMixinKeys are mutually exclusive when includedMixinPaths is non-empty. Malformed glob patterns are rejected with a validation error on configuration writes.

get/indexing/{tenant}/configurations

Create a new configuration

post

Creates a new index configuration. Supported providers:

  • Algolia - https://www.algolia.com

  • Battery Included - https://www.batteryincluded.io

Identifier of a newly created configuration is a provider name. Only one provider can be active per tenant at a time.

Required scopes
This endpoint requires the following scopes:
  • : Needed to manage an index provider configuration
Authorizations
OAuth2clientCredentialsRequired
Token URL:
Path parameters
tenantstring · min: 3 · max: 16Required

The tenant that the caller is acting upon.

Please note that this value is always lowercase.

Pattern: ^[a-z][a-z0-9]+$
Body
searchKeystringOptional

API Key used for search purposes.

applicationIdstringOptional

Application id of an indexer provider.

indexNamestringOptional

Identifier of an index.

providerstring · enumRequired

Index provider name. Supported providers: ALGOLIA (https://www.algolia.com), BATTERY_INCLUDED (https://www.batteryincluded.io). Only one provider can be active per tenant at a time.

Possible values:
activebooleanOptional

Indicates if the configuration is active or not.

writeKeystringOptional

API key used for write purposes.

excludedMixinKeysstring[]Optional

Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the BATTERY_INCLUDED provider.

includedMixinPathsstring[]Optional

Optional allowlist of product mixin paths to include in indexing for the BATTERY_INCLUDED provider. Patterns are matched against full dot-notation paths rooted at the mixin key, for example class_EA673_toolsClassification.sk.OnlineIsService_P. * matches within a single path segment, ** matches across one or more path segments, and matching is case sensitive. If a matched path points to an object, the entire subtree under that object is included. When this field is absent or an empty list, path filtering is inactive and existing excludedMixinKeys behavior applies. includedMixinPaths and excludedMixinKeys are mutually exclusive when includedMixinPaths is non-empty. Malformed glob patterns are rejected with a validation error on configuration writes.

Responses
201

Created

application/json
idstringOptional

Identifier of a newly created configuration.

post/indexing/{tenant}/configurations

Get configuration by provider name

get

Retrieves a single configuration by a provider name. Supported providers:

  • Algolia - https://www.algolia.com

  • Battery Included - https://www.batteryincluded.io

Required scopes
This endpoint requires the following scopes:
  • : Needed to read an index provider configuration
Authorizations
OAuth2clientCredentialsRequired
Token URL:
Path parameters
tenantstring · min: 3 · max: 16Required

The tenant that the caller is acting upon.

Please note that this value is always lowercase.

Pattern: ^[a-z][a-z0-9]+$
providerstring · enumRequired

Provider name. Supported values: ALGOLIA, BATTERY_INCLUDED

Possible values:
Responses
200Success
application/json
searchKeystringOptional

API Key used for search purposes.

applicationIdstringOptional

Application id of an indexer provider.

indexNamestringOptional

Identifier of an index.

providerstring · enumRequired

Index provider name. Supported providers: ALGOLIA (https://www.algolia.com), BATTERY_INCLUDED (https://www.batteryincluded.io). Only one provider can be active per tenant at a time.

Possible values:
activebooleanOptional

Indicates if the configuration is active or not.

writeKeystringOptional

API key used for write purposes.

excludedMixinKeysstring[]Optional

Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the BATTERY_INCLUDED provider.

includedMixinPathsstring[]Optional

Optional allowlist of product mixin paths to include in indexing for the BATTERY_INCLUDED provider. Patterns are matched against full dot-notation paths rooted at the mixin key, for example class_EA673_toolsClassification.sk.OnlineIsService_P. * matches within a single path segment, ** matches across one or more path segments, and matching is case sensitive. If a matched path points to an object, the entire subtree under that object is included. When this field is absent or an empty list, path filtering is inactive and existing excludedMixinKeys behavior applies. includedMixinPaths and excludedMixinKeys are mutually exclusive when includedMixinPaths is non-empty. Malformed glob patterns are rejected with a validation error on configuration writes.

get/indexing/{tenant}/configurations/{provider}

Update configuration by provider name

put

Updates an existing index configuration.

Required scopes
This endpoint requires the following scopes:
  • : Needed to manage an index provider configuration
Authorizations
OAuth2clientCredentialsRequired
Token URL:
Path parameters
tenantstring · min: 3 · max: 16Required

The tenant that the caller is acting upon.

Please note that this value is always lowercase.

Pattern: ^[a-z][a-z0-9]+$
providerstring · enumRequired

Provider name. Supported values: ALGOLIA, BATTERY_INCLUDED

Possible values:
Body
searchKeystringOptional

API Key used for search purposes.

applicationIdstringOptional

Application id of an indexer provider.

indexNamestringOptional

Identifier of an index.

providerstring · enumRequired

Index provider name. Supported providers: ALGOLIA (https://www.algolia.com), BATTERY_INCLUDED (https://www.batteryincluded.io). Only one provider can be active per tenant at a time.

Possible values:
activebooleanOptional

Indicates if the configuration is active or not.

writeKeystringOptional

API key used for write purposes.

excludedMixinKeysstring[]Optional

Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the BATTERY_INCLUDED provider.

includedMixinPathsstring[]Optional

Optional allowlist of product mixin paths to include in indexing for the BATTERY_INCLUDED provider. Patterns are matched against full dot-notation paths rooted at the mixin key, for example class_EA673_toolsClassification.sk.OnlineIsService_P. * matches within a single path segment, ** matches across one or more path segments, and matching is case sensitive. If a matched path points to an object, the entire subtree under that object is included. When this field is absent or an empty list, path filtering is inactive and existing excludedMixinKeys behavior applies. includedMixinPaths and excludedMixinKeys are mutually exclusive when includedMixinPaths is non-empty. Malformed glob patterns are rejected with a validation error on configuration writes.

Responses
204

Configuration updated

No content

put/indexing/{tenant}/configurations/{provider}

No content

Delete configuration

delete

Deletes the configuration based on the provider name.

Required scopes
This endpoint requires the following scopes:
  • : Needed to manage an index provider configuration
Authorizations
OAuth2clientCredentialsRequired
Token URL:
Path parameters
tenantstring · min: 3 · max: 16Required

The tenant that the caller is acting upon.

Please note that this value is always lowercase.

Pattern: ^[a-z][a-z0-9]+$
providerstring · enumRequired

Provider name. Supported values: ALGOLIA, BATTERY_INCLUDED

Possible values:
Responses
204

Configuration deleted

No content

delete/indexing/{tenant}/configurations/{provider}

No content

Last updated

Was this helpful?