Distinct attribute

Child route of the settings route.

Distinct attribute is a field whose value will always be unique in the returned documents.

Distinct attribute can also be updated directly through the global settings route along with the other settings.

NOTE

Updating the settings means overwriting the default settings of MeiliSearch. You can reset to default values using the DELETE routes.

Learn more about distinct attribute.

Get distinct attribute

GET

  1. /indexes/:index_uid/settings/distinct-attribute

Get the distinct attribute field of an index.

Path variables

VariableDescription
index_uidThe index UID

Example

cURL

JavaScript

Python

PHP

Ruby

Go

Rust

  1. curl \
  2. -X GET 'http://localhost:7700/indexes/movies/settings/distinct-attribute'
  1. client.index('movies').getDistinctAttribute()
  1. client.index('movies').get_distinct_attribute()
  1. $client->index('movies')->getDistinctAttribute();
  1. client.index('movies').distinct_attribute
  1. client.Index("movies").GetDistinctAttribute()
  1. let distinct_attribute: Option<String> = movies.get_distinct_attribute().await.unwrap();

Response: 200 Ok

  1. "movie_id"

Update distinct attribute

POST

  1. /indexes/:index_uid/settings/distinct-attribute

Update the distinct attribute field of an index.

Path variables

VariableDescription
index_uidThe index UID

Body

A String: the field name.

More information about the body.

WARNING

If the field does not exist, no error will be thrown.

Example

cURL

JavaScript

Python

PHP

Ruby

Go

Rust

  1. curl \
  2. -X POST 'http://localhost:7700/indexes/movies/settings/distinct-attribute' \
  3. --data '"movie_id"'
  1. client.index('movies').updateDistinctAttribute('movie_id')
  1. client.index('movies').update_distinct_attribute('movie_id')
  1. $client->index('movies')->updateDistinctAttribute('movie_id');
  1. client.index('movies').update_distinct_attribute('movie_id')
  1. client.Index("movies").UpdateDistinctAttribute("movie_id")
  1. let progress: Progress = movies.set_distinct_attribute("movie_id").await.unwrap();

Response: 202 Accepted

  1. {
  2. "updateId": 1
  3. }

This updateId allows you to track the current update.

Reset distinct attribute

DELETE

  1. /indexes/:index_uid/settings/distinct-attribute

Reset the distinct attribute field of an index to its default value.

Default value: null

Path variables

VariableDescription
index_uidThe index UID

Example

cURL

JavaScript

Python

PHP

Ruby

Go

Rust

  1. curl \
  2. -X DELETE 'http://localhost:7700/indexes/movies/settings/distinct-attribute'
  1. client.index('movies').resetDistinctAttribute()
  1. client.index('movies').reset_distinct_attribute()
  1. $client->index('movies')->resetDistinctAttribute();
  1. client.index('movies').reset_distinct_attribute
  1. client.Index("movies").ResetDistinctAttribute()
  1. let progress: Progress = movies.reset_distinct_attribute().await.unwrap();

Response: 202 Accepted

  1. {
  2. "updateId": 1
  3. }

This updateId allows you to track the current update.