---
type: api
title: Disable the history snapshot task
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana-serverless/operation/operation-put-security-entity-store-history-snapshot-disable
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana-serverless/operation/operation-put-security-entity-store-history-snapshot-disable
products:
  - Kibana
---

# Disable the history snapshot task

Availability:

- Server: `https://{kibana_url}`

## Paths

- `PUT` `/api/security/entity_store/history_snapshot/disable`
- `PUT` `/s/{space_id}/api/security/entity_store/history_snapshot/disable`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana-serverless/authentication#apikeyauth)

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Disable the Entity Store history snapshot task for this space so it no longer creates snapshot indices. Existing snapshot indices remain unless you set `clearHistorySnapshots` to `true`. Returns 404 if the Entity Store is not installed in the current space.<br/><br/>[Required authorization] Route required privileges: securitySolution.

## Request Body

`application/json`

- `clearHistorySnapshots` (boolean · default: false) — optional
  When `true`, deletes existing history snapshot indices for this space in the background after the task is disabled. The response returns immediately and does not wait for deletion to finish. Deletion failures are logged and are not returned to the caller. If the task is already disabled, the request succeeds and does not delete indices. Defaults to `false`.

## Responses

#### `200`

Indicates a successful response.

#### `404`

Entity store is not installed.

## Code Examples

#### Console

```console
PUT kbn://api/security/entity_store/history_snapshot/disable
{}
```

#### Console

```console
PUT kbn://api/security/entity_store/history_snapshot/disable
{
  "clearHistorySnapshots": true
}
```

#### curl

```curl
curl -X PUT -H "kbn-xsrf: true" -H "Content-Type: application/json" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -d '{}' \
  "${KIBANA_URL}/api/security/entity_store/history_snapshot/disable"
```

#### curl

```curl
curl -X PUT -H "kbn-xsrf: true" -H "Content-Type: application/json" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -d '{"clearHistorySnapshots":true}' \
  "${KIBANA_URL}/api/security/entity_store/history_snapshot/disable"
```

## Response Examples

#### History snapshot task disabled

The Entity Store history snapshot task was disabled.

```json
{
  "ok": true
}
```

#### Entity store not installed

The Entity Store history snapshot task cannot be disabled because the entity store is not installed.

```json
{
  "error": "Not Found",
  "message": "Entity store is not installed",
  "statusCode": 404
}
```