---
title: InfluxDB Anti-Entropy API
description: Monitor and repair shards on InfluxDB Enterprise v1 data nodes the InfluxDB Anti-Entropy API.
url: https://docs.influxdata.com/enterprise_influxdb/v1/administration/configure/anti-entropy/anti-entropy-api/
estimated_tokens: 1730
publisher: InfluxData
canonical: https://docs.influxdata.com/enterprise_influxdb/v1/administration/configure/anti-entropy/anti-entropy-api/
date: '2025-10-24T12:52:47-05:00'
lastmod: '2025-10-24T12:52:47-05:00'
---

>
>
> **Note:** The Anti-Entropy API is available from the meta nodes and is only available when the Anti-Entropy service is enabled in the data node configuration settings. For information on the configuration settings, see[Anti-Entropy settings](/enterprise_influxdb/v1/administration/config-data-nodes/#anti-entropy-ae-settings).
>
>

Use the [Anti-Entropy service](/enterprise_influxdb/v1/administration/anti-entropy) in InfluxDB Enterprise to monitor and repair entropy in data nodes and their shards. To access the Anti-Entropy API and work with this service, use [`influxd-ctl entropy`](/enterprise_influxdb/v1/tools/influxd-ctl/entropy/) (also available on meta nodes).

The base URL is:

```text
http://localhost:8086/shard-repair
```

## GET `/status`

### Description

Lists shards that are in an inconsistent state and in need of repair.

### Parameters

| Name  |Located in|                               Description                                |Required| Type  |
|-------|----------|--------------------------------------------------------------------------|--------|-------|
|`local`|  query   |Limits status check to local shards on the data node handling this request|   No   |boolean|

### Responses

#### Headers

|Header name|      Value       |
|-----------|------------------|
| `Accept`  |`application/json`|

#### Status codes

|Code |     Description      | Type |
|-----|----------------------|------|
|`200`|`Successful operation`|object|

### Examples

#### cURL request

```bash
curl -X GET "http://localhost:8086/shard-repair/status?local=true" -H "accept: application/json"
```

#### Request URL

```text
http://localhost:8086/shard-repair/status?local=true
```

### Responses

Example of server response value:

```json
{
  "shards": [
    {
      "id": "1",
      "database": "ae",
      "retention_policy": "autogen",
      "start_time": "-259200000000000",
      "end_time": "345600000000000",
      "expires": "0",
      "status": "diff"
    },
    {
      "id": "3",
      "database": "ae",
      "retention_policy": "autogen",
      "start_time": "62640000000000000",
      "end_time": "63244800000000000",
      "expires": "0",
      "status": "diff"
    }
  ],
  "queued_shards": [
    "3",
    "5",
    "9"
  ],
  "processing_shards": [
    "3",
    "9"
  ]
}
```

## POST `/repair`

### Description

Queues the specified shard for repair of the inconsistent state.

### Parameters

|Name|Located in|          Description          |Required| Type  |
|----|----------|-------------------------------|--------|-------|
|`id`|  query   |ID of shard to queue for repair|  Yes   |integer|

### Responses

#### Headers

|Header name|      Value       |
|-----------|------------------|
| `Accept`  |`application/json`|

#### Status codes

|Code |      Description      |
|-----|-----------------------|
|`204`|`Successful operation` |
|`400`|     `Bad request`     |
|`500`|`Internal server error`|

### Examples

#### cURL request

```bash
curl -X POST "http://localhost:8086/shard-repair/repair?id=1" -H "accept: application/json"
```

#### Request URL

```text
http://localhost:8086/shard-repair/repair?id=1
```

## POST `/cancel-repair`

### Description

Removes the specified shard from the repair queue on nodes.

### Parameters

| Name  |Located in|                           Description                           |Required| Type  |
|-------|----------|-----------------------------------------------------------------|--------|-------|
| `id`  |  query   |             ID of shard to remove from repair queue             |  Yes   |integer|
|`local`|  query   |Only remove shard from repair queue on node receiving the request|   No   |boolean|

### Responses

#### Headers

|Header name|      Value       |
|-----------|------------------|
| `Accept`  |`application/json`|

#### Status codes

|Code |      Description      |
|-----|-----------------------|
|`204`|`Successful operation` |
|`400`|     `Bad request`     |
|`500`|`Internal server error`|

### Examples

#### cURL request

```bash
curl -X POST "http://localhost:8086/shard-repair/cancel-repair?id=1&local=false" -H "accept: application/json"
```

#### Request URL

```text
http://localhost:8086/shard-repair/cancel-repair?id=1&local=false
```

## Models

### ShardStatus

|       Name       | Type |Required|
|------------------|------|--------|
|       `id`       |string|   No   |
|    `database`    |string|   No   |
|`retention_policy`|string|   No   |
|   `start_time`   |string|   No   |
|    `end_time`    |string|   No   |
|    `expires`     |string|   No   |
|     `status`     |string|   No   |

### Examples

```json
{
  "shards": [
    {
      "id": "1",
      "database": "ae",
      "retention_policy": "autogen",
      "start_time": "-259200000000000",
      "end_time": "345600000000000",
      "expires": "0",
      "status": "diff"
    },
    {
      "id": "3",
      "database": "ae",
      "retention_policy": "autogen",
      "start_time": "62640000000000000",
      "end_time": "63244800000000000",
      "expires": "0",
      "status": "diff"
    }
  ],
  "queued_shards": [
    "3",
    "5",
    "9"
  ],
  "processing_shards": [
    "3",
    "9"
  ]
}
```
| Name | Located in | Description | Required | Type |
| --- | --- | --- | --- | --- |
| Name | Located in | Description | Required | Type |
| local | query | Limits status check to local shards on the data node handling this request | No | boolean |

| Header name | Value |
| --- | --- |
| Header name | Value |
| Accept | application/json |

| Code | Description | Type |
| --- | --- | --- |
| Code | Description | Type |
| 200 | Successful operation | object |

| Name | Located in | Description | Required | Type |
| --- | --- | --- | --- | --- |
| Name | Located in | Description | Required | Type |
| id | query | ID of shard to queue for repair | Yes | integer |

| Header name | Value |
| --- | --- |
| Header name | Value |
| Accept | application/json |

| Code | Description |
| --- | --- |
| Code | Description |
| 204 | Successful operation |
| 400 | Bad request |
| 500 | Internal server error |

| Name | Located in | Description | Required | Type |
| --- | --- | --- | --- | --- |
| Name | Located in | Description | Required | Type |
| id | query | ID of shard to remove from repair queue | Yes | integer |
| local | query | Only remove shard from repair queue on node receiving the request | No | boolean |

| Header name | Value |
| --- | --- |
| Header name | Value |
| Accept | application/json |

| Code | Description |
| --- | --- |
| Code | Description |
| 204 | Successful operation |
| 400 | Bad request |
| 500 | Internal server error |

| Name | Type | Required |
| --- | --- | --- |
| Name | Type | Required |
| id | string | No |
| database | string | No |
| retention_policy | string | No |
| start_time | string | No |
| end_time | string | No |
| expires | string | No |
| status | string | No |