---
title: "Change your analytics defaults"
description: "settings: the kinds to change (others stay)."
canonical_url: https://docs.markdrop.in/api/analytics/change-your-analytics-defaults
last_updated: 2026-11-20
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Change your analytics defaults

`PUT https://api.markdrop.in/api/v1/me/analytics-settings`

`settings`: the kinds to change (others stay). `delete`: kinds whose already collected data should be deleted too, on your items where they're now off (an item with its own setting turned on keeps its data). Applies from now on.

- **Authentication:** API token required: `Authorization: Bearer mdk_…`.
- **Rate limit:** 30 per minute per IP address.
- **MCP tool:** `set_analytics_settings` ([tools](https://docs.markdrop.in/ai/tools))
- **Guide:** [Choose what's tracked](https://docs.markdrop.in/analytics/viewers#choose-whats-tracked)

## Request body

`application/json`, required.

- `settings` (object)
- `delete` (array of string): Up to 9 items.

## Responses

- `200`: OK.
- `401`: No token, or the token is revoked or mistyped.
- `422`: The request didn't validate. `detail` lists each problem, with where it is (`loc`) and why (`msg`).
- `429`: Too many requests from your IP address. Wait the seconds in `Retry-After`.

## Examples

**curl**

```bash
curl -X PUT https://api.markdrop.in/api/v1/me/analytics-settings \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"settings":{"identity":false},"delete":[]}'
```

**JavaScript**

```javascript
const res = await fetch("https://api.markdrop.in/api/v1/me/analytics-settings", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "settings": {
      "identity": false
    },
    "delete": []
  }),
});
const data = await res.json();
```

**Python**

```python
import os

import requests

r = requests.put(
    "https://api.markdrop.in/api/v1/me/analytics-settings",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"settings": {"identity": False}, "delete": []},
)
r.raise_for_status()
print(r.json())
```
