Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
(asynchronously) Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
(asynchronously) Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl).
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl).
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl).
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl).
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
(asynchronously) This `operation`, _copy_ or _move_, will copy or move a source
index's (`IndexName`) records, settings, synonyms, and rules to a
`destination` index.
(asynchronously) This `operation`, _copy_ or _move_, will copy or move a source
index's (`IndexName`) records, settings, synonyms, and rules to a
`destination` index.
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it.
Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
(asynchronously) Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
(asynchronously) Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria.
Add a new API key with specific permissions and restrictions. The request must be authenticated
with the admin API key. The response returns an API key string.
Parameters:
apiKey - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Add a new API key with specific permissions and restrictions. The request must be authenticated
with the admin API key. The response returns an API key string.
(asynchronously) Add a new API key with specific permissions and restrictions. The request must
be authenticated with the admin API key. The response returns an API key string.
Parameters:
apiKey - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Add a new API key with specific permissions and restrictions. The request must
be authenticated with the admin API key. The response returns an API key string.
If you use an existing `objectID`, the existing record will be replaced with the new one. To
update only some attributes of an existing record, use the [`partial`
operation](#tag/Records/operation/partialUpdateObject) instead. To add multiple records to your
index in a single API request, use the [`batch` operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
body - Algolia record. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
If you use an existing `objectID`, the existing record will be replaced with the new one. To
update only some attributes of an existing record, use the [`partial`
operation](#tag/Records/operation/partialUpdateObject) instead. To add multiple records to your
index in a single API request, use the [`batch` operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
(asynchronously) If you use an existing `objectID`, the existing record will be
replaced with the new one. To update only some attributes of an existing record, use the
[`partial` operation](#tag/Records/operation/partialUpdateObject) instead. To add
multiple records to your index in a single API request, use the [`batch`
operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
body - Algolia record. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) If you use an existing `objectID`, the existing record will be
replaced with the new one. To update only some attributes of an existing record, use the
[`partial` operation](#tag/Records/operation/partialUpdateObject) instead. To add
multiple records to your index in a single API request, use the [`batch`
operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
To reduce the time spent on network round trips, you can perform several write actions in a
single API call. Actions are applied in the order they are specified. The supported `action`s
are equivalent to the individual operations of the same name.
Parameters:
indexName - Index on which to perform the request. (required)
batchWriteParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
To reduce the time spent on network round trips, you can perform several write actions in a
single API call. Actions are applied in the order they are specified. The supported `action`s
are equivalent to the individual operations of the same name.
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) To reduce the time spent on network round trips, you can perform several write
actions in a single API call. Actions are applied in the order they are specified. The
supported `action`s are equivalent to the individual operations of the same name.
Parameters:
indexName - Index on which to perform the request. (required)
batchWriteParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) To reduce the time spent on network round trips, you can perform several write
actions in a single API call. Actions are applied in the order they are specified. The
supported `action`s are equivalent to the individual operations of the same name.
Parameters:
indexName - Index on which to perform the request. (required)
Retrieve up to 1,000 records per call. Supports full-text search and filters. For better
performance, it doesn't support: - The `distinct` query parameter - Sorting by typos,
proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
browseParams - (optional)
innerType - The class held by the index, could be your custom class or Object.
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Retrieve up to 1,000 records per call. Supports full-text search and filters. For better
performance, it doesn't support: - The `distinct` query parameter - Sorting by typos,
proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
browseParams - (optional)
innerType - The class held by the index, could be your custom class or Object.
Retrieve up to 1,000 records per call. Supports full-text search and filters. For better
performance, it doesn't support: - The `distinct` query parameter - Sorting by typos,
proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
innerType - The class held by the index, could be your custom class or Object.
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Retrieve up to 1,000 records per call. Supports full-text search and filters. For better
performance, it doesn't support: - The `distinct` query parameter - Sorting by typos,
proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
innerType - The class held by the index, could be your custom class or Object.
(asynchronously) Retrieve up to 1,000 records per call. Supports full-text search and filters.
For better performance, it doesn't support: - The `distinct` query parameter -
Sorting by typos, proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
browseParams - (optional)
innerType - The class held by the index, could be your custom class or Object.
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Returns:
CompletableFuture<BrowseResponse> The awaitable future
(asynchronously) Retrieve up to 1,000 records per call. Supports full-text search and filters.
For better performance, it doesn't support: - The `distinct` query parameter -
Sorting by typos, proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
browseParams - (optional)
innerType - The class held by the index, could be your custom class or Object.
Returns:
CompletableFuture<BrowseResponse> The awaitable future
(asynchronously) Retrieve up to 1,000 records per call. Supports full-text search and filters.
For better performance, it doesn't support: - The `distinct` query parameter -
Sorting by typos, proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
innerType - The class held by the index, could be your custom class or Object.
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Returns:
CompletableFuture<BrowseResponse> The awaitable future
(asynchronously) Retrieve up to 1,000 records per call. Supports full-text search and filters.
For better performance, it doesn't support: - The `distinct` query parameter -
Sorting by typos, proximity, words, or geographical distance.
Parameters:
indexName - Index on which to perform the request. (required)
innerType - The class held by the index, could be your custom class or Object.
Returns:
CompletableFuture<BrowseResponse> The awaitable future
This operation doesn't support all the query options, only its filters (numeric, facet, or tag)
and geo queries. It doesn't accept empty filters or queries.
Parameters:
indexName - Index on which to perform the request. (required)
deleteByParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
This operation doesn't support all the query options, only its filters (numeric, facet, or tag)
and geo queries. It doesn't accept empty filters or queries.
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) This operation doesn't support all the query options, only its filters
(numeric, facet, or tag) and geo queries. It doesn't accept empty filters or queries.
Parameters:
indexName - Index on which to perform the request. (required)
deleteByParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) This operation doesn't support all the query options, only its filters
(numeric, facet, or tag) and geo queries. It doesn't accept empty filters or queries.
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) Delete a synonym by its `objectID`. To find the object IDs of your
synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Delete a synonym by its `objectID`. To find the object IDs of your
synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
(asynchronously) Delete a synonym by its `objectID`. To find the object IDs of your
synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Delete a synonym by its `objectID`. To find the object IDs of your
synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
Get the permissions and restrictions of a specific API key. When authenticating with the admin
API key, you can request information for any of your application's keys. When authenticating
with other API keys, you can only retrieve information for that key.
Parameters:
key - API key. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Get the permissions and restrictions of a specific API key. When authenticating with the admin
API key, you can request information for any of your application's keys. When authenticating
with other API keys, you can only retrieve information for that key.
(asynchronously) Get the permissions and restrictions of a specific API key. When
authenticating with the admin API key, you can request information for any of your
application's keys. When authenticating with other API keys, you can only retrieve
information for that key.
Parameters:
key - API key. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Get the permissions and restrictions of a specific API key. When
authenticating with the admin API key, you can request information for any of your
application's keys. When authenticating with other API keys, you can only retrieve
information for that key.
Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
(asynchronously) Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Returns:
CompletableFuture<Map<String, Languages>> The awaitable future
(asynchronously) Lists Algolia's [supported
languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/)
and any customizations applied to each language's [stop
word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
and [segmentation
(compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
features.
Returns:
CompletableFuture<Map<String, Languages>> The awaitable future
The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server. This
request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed Search
Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
Parameters:
offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most
recent. (optional, default to 0)
length - Maximum number of entries to retrieve. (optional, default to 10)
indexName - Index for which log entries should be retrieved. When omitted, log entries are
retrieved for all indices. (optional)
type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
(optional, default to all)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server. This
request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed Search
Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
Parameters:
offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most
recent. (optional, default to 0)
length - Maximum number of entries to retrieve. (optional, default to 10)
indexName - Index for which log entries should be retrieved. When omitted, log entries are
retrieved for all indices. (optional)
type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
(optional, default to all)
The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server. This
request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed Search
Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server. This
request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed Search
Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server.
This request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed
Search Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
Parameters:
offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most
recent. (optional, default to 0)
length - Maximum number of entries to retrieve. (optional, default to 10)
indexName - Index for which log entries should be retrieved. When omitted, log entries are
retrieved for all indices. (optional)
type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
(optional, default to all)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server.
This request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed
Search Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
Parameters:
offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most
recent. (optional, default to 0)
length - Maximum number of entries to retrieve. (optional, default to 10)
indexName - Index for which log entries should be retrieved. When omitted, log entries are
retrieved for all indices. (optional)
type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
(optional, default to all)
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server.
This request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed
Search Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) The request must be authenticated by an API key with the [`logs`
ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are
held for the last seven days. There's also a logging limit of 1,000 API calls per server.
This request counts towards your [operations
quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)
but doesn't appear in the logs itself. > **Note**: To fetch the logs for a Distributed
Search Network (DSN) cluster, target the [DSN's
endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToRetrieve - Attributes to include with the records in the response. This is
useful to reduce the size of the API response. By default, all retrievable attributes are
returned. `objectID` is always retrieved, even when not specified.
[`unretrievableAttributes`](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/)
won't be retrieved unless the request is authenticated with the admin API key. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToRetrieve - Attributes to include with the records in the response. This is
useful to reduce the size of the API response. By default, all retrievable attributes are
returned. `objectID` is always retrieved, even when not specified.
[`unretrievableAttributes`](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/)
won't be retrieved unless the request is authenticated with the admin API key. (optional)
(asynchronously) To get more than one record, use the [`objects`
operation](#tag/Records/operation/getObjects).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToRetrieve - Attributes to include with the records in the response. This is
useful to reduce the size of the API response. By default, all retrievable attributes are
returned. `objectID` is always retrieved, even when not specified.
[`unretrievableAttributes`](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/)
won't be retrieved unless the request is authenticated with the admin API key. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Returns:
CompletableFuture<Map<String, String>> The awaitable future
(asynchronously) To get more than one record, use the [`objects`
operation](#tag/Records/operation/getObjects).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToRetrieve - Attributes to include with the records in the response. This is
useful to reduce the size of the API response. By default, all retrievable attributes are
returned. `objectID` is always retrieved, even when not specified.
[`unretrievableAttributes`](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/)
won't be retrieved unless the request is authenticated with the admin API key. (optional)
Returns:
CompletableFuture<Map<String, String>> The awaitable future
Retrieve one or more records, potentially from different indices, in a single API operation.
Results will be received in the same order as the requests.
Parameters:
getObjectsParams - Request object. (required)
innerType - The class held by the index, could be your custom class or Object.
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Retrieve one or more records, potentially from different indices, in a single API operation.
Results will be received in the same order as the requests.
Parameters:
getObjectsParams - Request object. (required)
innerType - The class held by the index, could be your custom class or Object.
(asynchronously) Retrieve one or more records, potentially from different indices, in a single
API operation. Results will be received in the same order as the requests.
Parameters:
getObjectsParams - Request object. (required)
innerType - The class held by the index, could be your custom class or Object.
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Returns:
CompletableFuture<GetObjectsResponse> The awaitable future
(asynchronously) Retrieve one or more records, potentially from different indices, in a single
API operation. Results will be received in the same order as the requests.
Parameters:
getObjectsParams - Request object. (required)
innerType - The class held by the index, could be your custom class or Object.
Returns:
CompletableFuture<GetObjectsResponse> The awaitable future
(asynchronously) Get a syonym by its `objectID`. To find the object IDs for your
synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Get a syonym by its `objectID`. To find the object IDs for your
synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
Get the IDs of the 10 users with the highest number of records per cluster. Since it can take
up to a few seconds to get the data from the different clusters, the response isn't real-time.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Get the IDs of the 10 users with the highest number of records per cluster. Since it can take
up to a few seconds to get the data from the different clusters, the response isn't real-time.
(asynchronously) Get the IDs of the 10 users with the highest number of records per cluster.
Since it can take up to a few seconds to get the data from the different clusters, the response
isn't real-time.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Get the IDs of the 10 users with the highest number of records per cluster.
Since it can take up to a few seconds to get the data from the different clusters, the response
isn't real-time.
Returns the userID data stored in the mapping. Since it can take up to a few seconds to get the
data from the different clusters, the response isn't real-time.
Parameters:
userID - userID to assign. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Returns the userID data stored in the mapping. Since it can take up to a few seconds to get the
data from the different clusters, the response isn't real-time.
(asynchronously) Returns the userID data stored in the mapping. Since it can take up to a few
seconds to get the data from the different clusters, the response isn't real-time.
Parameters:
userID - userID to assign. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Returns the userID data stored in the mapping. Since it can take up to a few
seconds to get the data from the different clusters, the response isn't real-time.
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
Parameters:
getClusters - Indicates whether to include the cluster's pending mapping state in the
response. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
Parameters:
getClusters - Indicates whether to include the cluster's pending mapping state in the
response. (optional)
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
To determine when the time-consuming process of creating a large batch of users or migrating
users from one cluster to another is complete, this operation retrieves the status of the
process.
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
Parameters:
getClusters - Indicates whether to include the cluster's pending mapping state in the
response. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
Parameters:
getClusters - Indicates whether to include the cluster's pending mapping state in the
response. (optional)
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) To determine when the time-consuming process of creating a large batch of
users or migrating users from one cluster to another is complete, this operation retrieves the
status of the process.
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
(asynchronously) List indices in an Algolia application.
Parameters:
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) List indices in an Algolia application.
Parameters:
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
List the userIDs assigned to a multi-cluster application. Since it can take up to a few seconds
to get the data from the different clusters, the response isn't real-time.
Parameters:
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
List the userIDs assigned to a multi-cluster application. Since it can take up to a few seconds
to get the data from the different clusters, the response isn't real-time.
Parameters:
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
List the userIDs assigned to a multi-cluster application. Since it can take up to a few seconds
to get the data from the different clusters, the response isn't real-time.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
List the userIDs assigned to a multi-cluster application. Since it can take up to a few seconds
to get the data from the different clusters, the response isn't real-time.
(asynchronously) List the userIDs assigned to a multi-cluster application. Since it can take up
to a few seconds to get the data from the different clusters, the response isn't real-time.
Parameters:
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) List the userIDs assigned to a multi-cluster application. Since it can take up
to a few seconds to get the data from the different clusters, the response isn't real-time.
Parameters:
page - Returns the requested page number. The page size is determined by the `hitsPerPage`
parameter. You can see the number of available pages in the `nbPages` response attribute.
When `page` is null, the API response is not paginated. (optional)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
(asynchronously) List the userIDs assigned to a multi-cluster application. Since it can take up
to a few seconds to get the data from the different clusters, the response isn't real-time.
Parameters:
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) List the userIDs assigned to a multi-cluster application. Since it can take up
to a few seconds to get the data from the different clusters, the response isn't real-time.
To reduce the time spent on network round trips, you can perform several write actions in a
single request. It's a multi-index version of the [`batch`
operation](#tag/Records/operation/batch). Actions are applied in the order they are specified.
The supported actions are equivalent to the individual operations of the same name.
Parameters:
batchParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
To reduce the time spent on network round trips, you can perform several write actions in a
single request. It's a multi-index version of the [`batch`
operation](#tag/Records/operation/batch). Actions are applied in the order they are specified.
The supported actions are equivalent to the individual operations of the same name.
(asynchronously) To reduce the time spent on network round trips, you can perform several write
actions in a single request. It's a multi-index version of the [`batch`
operation](#tag/Records/operation/batch). Actions are applied in the order they are specified.
The supported actions are equivalent to the individual operations of the same name.
Parameters:
batchParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) To reduce the time spent on network round trips, you can perform several write
actions in a single request. It's a multi-index version of the [`batch`
operation](#tag/Records/operation/batch). Actions are applied in the order they are specified.
The supported actions are equivalent to the individual operations of the same name.
This `operation`, _copy_ or _move_, will copy or move a source index's (`IndexName`) records,
settings, synonyms, and rules to a `destination` index. If the destination index exists, it
will be replaced, except for index-specific API keys and analytics data. If the destination
index doesn't exist, it will be created. The choice between moving or copying an index depends
on your needs. Choose: - **Move** to rename an index. - **Copy** to create a new index with the
same records and configuration as an existing one. > **Note**: When considering copying or
moving, be aware of the [rate
limitations](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits)
on these processes and the [impact on your analytics
data](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/concepts/indices-analytics/).
Parameters:
indexName - Index on which to perform the request. (required)
operationIndexParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
This `operation`, _copy_ or _move_, will copy or move a source index's (`IndexName`) records,
settings, synonyms, and rules to a `destination` index. If the destination index exists, it
will be replaced, except for index-specific API keys and analytics data. If the destination
index doesn't exist, it will be created. The choice between moving or copying an index depends
on your needs. Choose: - **Move** to rename an index. - **Copy** to create a new index with the
same records and configuration as an existing one. > **Note**: When considering copying or
moving, be aware of the [rate
limitations](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits)
on these processes and the [impact on your analytics
data](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/concepts/indices-analytics/).
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) This `operation`, _copy_ or _move_, will copy or move a source
index's (`IndexName`) records, settings, synonyms, and rules to a
`destination` index. If the destination index exists, it will be replaced, except for
index-specific API keys and analytics data. If the destination index doesn't exist, it will
be created. The choice between moving or copying an index depends on your needs. Choose: -
**Move** to rename an index. - **Copy** to create a new index with the same records and
configuration as an existing one. > **Note**: When considering copying or moving, be aware
of the [rate
limitations](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits)
on these processes and the [impact on your analytics
data](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/concepts/indices-analytics/).
Parameters:
indexName - Index on which to perform the request. (required)
operationIndexParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) This `operation`, _copy_ or _move_, will copy or move a source
index's (`IndexName`) records, settings, synonyms, and rules to a
`destination` index. If the destination index exists, it will be replaced, except for
index-specific API keys and analytics data. If the destination index doesn't exist, it will
be created. The choice between moving or copying an index depends on your needs. Choose: -
**Move** to rename an index. - **Copy** to create a new index with the same records and
configuration as an existing one. > **Note**: When considering copying or moving, be aware
of the [rate
limitations](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits)
on these processes and the [impact on your analytics
data](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/concepts/indices-analytics/).
Parameters:
indexName - Index on which to perform the request. (required)
Add new attributes or update current ones in an existing record. You can use any first-level
attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
createIfNotExists - Indicates whether to create a new record if it doesn't exist yet.
(optional, default to true)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Add new attributes or update current ones in an existing record. You can use any first-level
attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
createIfNotExists - Indicates whether to create a new record if it doesn't exist yet.
(optional, default to true)
Add new attributes or update current ones in an existing record. You can use any first-level
attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Add new attributes or update current ones in an existing record. You can use any first-level
attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
(asynchronously) Add new attributes or update current ones in an existing record. You can use
any first-level attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
createIfNotExists - Indicates whether to create a new record if it doesn't exist yet.
(optional, default to true)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Add new attributes or update current ones in an existing record. You can use
any first-level attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
createIfNotExists - Indicates whether to create a new record if it doesn't exist yet.
(optional, default to true)
(asynchronously) Add new attributes or update current ones in an existing record. You can use
any first-level attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Add new attributes or update current ones in an existing record. You can use
any first-level attribute but not nested attributes. If you specify a [nested
attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/),
the engine treats it as a replacement for its first-level ancestor.
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique record (object) identifier. (required)
attributesToUpdate - Object with attributes to update. (required)
Add a record (object) to an index or replace it. If the record doesn't contain an `objectID`,
Algolia automatically adds it. If you use an existing `objectID`, the existing record is
replaced with the new one. To add multiple records to your index in a single API request, use
the [`batch` operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
body - The Algolia record. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Add a record (object) to an index or replace it. If the record doesn't contain an `objectID`,
Algolia automatically adds it. If you use an existing `objectID`, the existing record is
replaced with the new one. To add multiple records to your index in a single API request, use
the [`batch` operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) Add a record (object) to an index or replace it. If the record doesn't
contain an `objectID`, Algolia automatically adds it. If you use an existing
`objectID`, the existing record is replaced with the new one. To add multiple records
to your index in a single API request, use the [`batch`
operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
body - The Algolia record. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Add a record (object) to an index or replace it. If the record doesn't
contain an `objectID`, Algolia automatically adds it. If you use an existing
`objectID`, the existing record is replaced with the new one. To add multiple records
to your index in a single API request, use the [`batch`
operation](#tag/Records/operation/batch).
Parameters:
indexName - Index on which to perform the request. (required)
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds a new one. If
you use an existing synonym `objectID`, the existing synonym is replaced with the new one. To
add multiple synonyms in a single API request, use the [`batch`
operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
synonymHit - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds a new one. If
you use an existing synonym `objectID`, the existing synonym is replaced with the new one. To
add multiple synonyms in a single API request, use the [`batch`
operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
synonymHit - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds a new one. If
you use an existing synonym `objectID`, the existing synonym is replaced with the new one. To
add multiple synonyms in a single API request, use the [`batch`
operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
synonymHit - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds a new one. If
you use an existing synonym `objectID`, the existing synonym is replaced with the new one. To
add multiple synonyms in a single API request, use the [`batch`
operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds
a new one. If you use an existing synonym `objectID`, the existing synonym is
replaced with the new one. To add multiple synonyms in a single API request, use the
[`batch` operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
synonymHit - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds
a new one. If you use an existing synonym `objectID`, the existing synonym is
replaced with the new one. To add multiple synonyms in a single API request, use the
[`batch` operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
synonymHit - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds
a new one. If you use an existing synonym `objectID`, the existing synonym is
replaced with the new one. To add multiple synonyms in a single API request, use the
[`batch` operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
synonymHit - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Add a
[synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms)
to an index or replace it. If the synonym `objectID` doesn't exist, Algolia adds
a new one. If you use an existing synonym `objectID`, the existing synonym is
replaced with the new one. To add multiple synonyms in a single API request, use the
[`batch` operation](#tag/Synonyms/operation/saveSynonyms).
Parameters:
indexName - Index on which to perform the request. (required)
objectID - Unique identifier of a synonym object. (required)
Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
Parameters:
dictionaryName - Dictionary to search in. (required)
searchDictionaryEntriesParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
Parameters:
dictionaryName - Dictionary to search in. (required)
(asynchronously) Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
Parameters:
dictionaryName - Dictionary to search in. (required)
searchDictionaryEntriesParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Search for standard and
[custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/)
entries in the [stop
words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/),
[plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/),
or [segmentation
(compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/)
dictionaries.
Parameters:
dictionaryName - Dictionary to search in. (required)
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and `hitsPerPage` are ignored). By
default, the engine returns a maximum of 10 values but you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
facetName - Facet name. (required)
searchForFacetValuesRequest - (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and `hitsPerPage` are ignored). By
default, the engine returns a maximum of 10 values but you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and `hitsPerPage` are ignored). By
default, the engine returns a maximum of 10 values but you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
facetName - Facet name. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
[Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and `hitsPerPage` are ignored). By
default, the engine returns a maximum of 10 values but you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and
`hitsPerPage` are ignored). By default, the engine returns a maximum of 10 values but
you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
facetName - Facet name. (required)
searchForFacetValuesRequest - (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and
`hitsPerPage` are ignored). By default, the engine returns a maximum of 10 values but
you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and
`hitsPerPage` are ignored). By default, the engine returns a maximum of 10 values but
you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
facetName - Facet name. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) [Search for a facet's
values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values),
optionally restricting the returned values to those contained in records matching other search
criteria. > **Note**: Pagination isn't supported (`page` and
`hitsPerPage` are ignored). By default, the engine returns a maximum of 10 values but
you can adjust this with `maxFacetHits`.
Parameters:
indexName - Index on which to perform the request. (required)
Search for synonyms in your index. You can control and filter the search with parameters. To
get all synonyms, send an empty request body.
Parameters:
indexName - Index on which to perform the request. (required)
type - Search for specific [types of
synonyms](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms).
(optional)
page - Returns the requested page number (the first page is 0). Page size is set by
`hitsPerPage`. When null, there's no pagination. (optional, default to 0)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
searchSynonymsParams - Body of the `searchSynonyms` operation. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Search for synonyms in your index. You can control and filter the search with parameters. To
get all synonyms, send an empty request body.
Parameters:
indexName - Index on which to perform the request. (required)
type - Search for specific [types of
synonyms](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms).
(optional)
page - Returns the requested page number (the first page is 0). Page size is set by
`hitsPerPage`. When null, there's no pagination. (optional, default to 0)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
searchSynonymsParams - Body of the `searchSynonyms` operation. (optional)
(asynchronously) Search for synonyms in your index. You can control and filter the search with
parameters. To get all synonyms, send an empty request body.
Parameters:
indexName - Index on which to perform the request. (required)
type - Search for specific [types of
synonyms](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms).
(optional)
page - Returns the requested page number (the first page is 0). Page size is set by
`hitsPerPage`. When null, there's no pagination. (optional, default to 0)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
searchSynonymsParams - Body of the `searchSynonyms` operation. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Search for synonyms in your index. You can control and filter the search with
parameters. To get all synonyms, send an empty request body.
Parameters:
indexName - Index on which to perform the request. (required)
type - Search for specific [types of
synonyms](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms).
(optional)
page - Returns the requested page number (the first page is 0). Page size is set by
`hitsPerPage`. When null, there's no pagination. (optional, default to 0)
hitsPerPage - Maximum number of hits per page. (optional, default to 100)
searchSynonymsParams - Body of the `searchSynonyms` operation. (optional)
(asynchronously) Search for synonyms in your index. You can control and filter the search with
parameters. To get all synonyms, send an empty request body.
Parameters:
indexName - Index on which to perform the request. (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Search for synonyms in your index. You can control and filter the search with
parameters. To get all synonyms, send an empty request body.
Parameters:
indexName - Index on which to perform the request. (required)
Since it can take up to a few seconds to get the data from the different clusters, the response
isn't real-time. To ensure rapid updates, the user IDs index isn't built at the same time as
the mapping. Instead, it's built every 12 hours, at the same time as the update of user ID
usage. For example, if you add or move a user ID, the search will show an old value until the
next time the mapping is rebuilt (every 12 hours).
Parameters:
searchUserIdsParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Since it can take up to a few seconds to get the data from the different clusters, the response
isn't real-time. To ensure rapid updates, the user IDs index isn't built at the same time as
the mapping. Instead, it's built every 12 hours, at the same time as the update of user ID
usage. For example, if you add or move a user ID, the search will show an old value until the
next time the mapping is rebuilt (every 12 hours).
(asynchronously) Since it can take up to a few seconds to get the data from the different
clusters, the response isn't real-time. To ensure rapid updates, the user IDs index
isn't built at the same time as the mapping. Instead, it's built every 12 hours, at the
same time as the update of user ID usage. For example, if you add or move a user ID, the search
will show an old value until the next time the mapping is rebuilt (every 12 hours).
Parameters:
searchUserIdsParams - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Since it can take up to a few seconds to get the data from the different
clusters, the response isn't real-time. To ensure rapid updates, the user IDs index
isn't built at the same time as the mapping. Instead, it's built every 12 hours, at the
same time as the update of user ID usage. For example, if you add or move a user ID, the search
will show an old value until the next time the mapping is rebuilt (every 12 hours).
Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
indexSettings - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
indexSettings - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
indexSettings - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
(asynchronously) Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
indexSettings - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
indexSettings - (required)
forwardToReplicas - Indicates whether changed index settings are forwarded to the replica
indices. (optional)
(asynchronously) Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
indexSettings - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Update the specified [index
settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null
for a setting resets it to its default value.
Parameters:
indexName - Index on which to perform the request. (required)
Replace the permissions of an existing API key. Any unspecified parameter resets that
permission to its default value. The request must be authenticated with the admin API key.
Parameters:
key - API key. (required)
apiKey - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
Replace the permissions of an existing API key. Any unspecified parameter resets that
permission to its default value. The request must be authenticated with the admin API key.
(asynchronously) Replace the permissions of an existing API key. Any unspecified parameter
resets that permission to its default value. The request must be authenticated with the admin
API key.
Parameters:
key - API key. (required)
apiKey - (required)
requestOptions - The requestOptions to send along with the query, they will be merged with
the transporter requestOptions.
(asynchronously) Replace the permissions of an existing API key. Any unspecified parameter
resets that permission to its default value. The request must be authenticated with the admin
API key.