---
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/4641/api/doc/kibana/v9/operation/operation-put-security-entity-store-history-snapshot-disable
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v9/operation/operation-put-security-entity-store-history-snapshot-disable
products:
  - Kibana
---

# Disable the history snapshot task

Authentication: required

Availability: Planned

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

## Paths

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

#### Path parameters

- `space_id` (string) — optional
  An identifier for the space. If `space_id` is not provided in the URL, the default space is used. Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

## Description

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.

## Required authorization

- Privileges: `securitySolution`

## Header parameters

- `kbn-xsrf` (string) — required
  A required header to protect against CSRF attacks

## 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.

`application/json`

#### `404`

Entity store is not installed.

`application/json`

## 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

`application/json`

The Entity Store history snapshot task was disabled.

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

#### Entity store not installed

`application/json`

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
}
```