# Pause, resume or set analysis

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

PATCH `/v1/trackers/{id}`

Pauses or resumes the Tracker, switches its analysis on or off, or both. A paused Tracker runs no cycles and is charged nothing. Analysis applies from the next cycle and is charged per new video or Ad it analyses.

## Price

Free.

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `id` | path | `string` | Required | — | Tracker id. |

## Request body

`application/json`

object

- `state` string one of `active`, `paused` Pause or resume. A paused Tracker runs no cycles.
- `intelligence` boolean Switch analysis of new videos or Ads on or off, from the next cycle. Pass this, `state`, or both.

## Responses

### 200 OK

`{ tracker }`.

object

- `tracker` object required
  - `id` string required
  - `kind` string required one of `creator`, `hashtag`, `sound`, `advertiser`, `keyword`, `video` `video` is deprecated (ADR 0024): existing Video Trackers keep working, new ones are refused with 400 `kind_deprecated`.
  - `platform` string required `meta` or `tiktok` for an advertiser Tracker.
  - `target` string required
  - `intelligence` boolean required Whether each new video (or Ad) the cycle finds is analysed.
  - `state` string required one of `active`, `paused`, `deleted`
  - `last_cycle_at` string required nullable
  - `last_run_id` string required nullable
  - `created_at` string required
  - `updated_at` string required
  - `coverage` string one of `library_regions_only`, `partial` `GET /v1/trackers/{id}`. TikTok advertiser: `library_regions_only` when its latest observation found no Ads in the TikTok ad library, which holds only Ads delivered in the EU/EEA, Switzerland, the UK and Turkey. Google advertiser: `partial` when it runs more Ads than a cycle lists. Keyword on Instagram or Facebook: `partial`, their search being a best-effort index. Absent otherwise.
  - `coverage_note` string The regions the TikTok ad library covers, beside `coverage`.
  - `focus` object The Tracker's Focus: which Videos are relevant to you. Terms are stored lowercased. Absent when it has none.
    - `text` string required
    - `must_mention` array of string required

### 401 Unauthorized

Codes: `missing_authorization`, `invalid_key`, `key_revoked`, `key_expired`, `invalid_token`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 409 Conflict

`tracker_limit_exceeded` when resuming would exceed the cap.

Code: `tracker_limit_exceeded`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

## Related guides

- [Trackers](https://www.shortsintel.com/docs/concepts/trackers): Standing watches on a creator or an Advertiser: how a cycle runs, when it reports a change, and how to pause one.

## Request samples

curl:

```bash
curl -X PATCH "https://www.shortsintel.com/v1/trackers/trk_4b1e90c7aa" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"paused","intelligence":true}'
```

TypeScript:

```typescript
const response = await fetch(
  "https://www.shortsintel.com/v1/trackers/trk_4b1e90c7aa",
  {
    method: "PATCH",
    headers: {
      "Authorization": "Bearer sk_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "state": "paused",
      "intelligence": true
    }),
  },
);

if (!response.ok) {
  throw new Error(`ShortsIntel ${response.status}`);
}

const data = await response.json();
```

Python:

```python
import requests

response = requests.patch(
    "https://www.shortsintel.com/v1/trackers/trk_4b1e90c7aa",
    headers={
        "Authorization": "Bearer sk_live_YOUR_KEY",
        "Content-Type": "application/json",
    },
    json={
        "state": "paused",
        "intelligence": True,
    },
)
response.raise_for_status()

data = response.json()
```

200 · `{ tracker }`.

```json
{
  "tracker": {
    "id": "trk_4b1e90c7aa",
    "kind": "creator",
    "platform": "tiktok",
    "target": "someone",
    "intelligence": true,
    "state": "paused",
    "last_cycle_at": "2026-09-08T04:00:11.402Z",
    "last_run_id": "run_c07a41bb92",
    "created_at": "2026-09-01T11:20:03.118Z",
    "updated_at": "2026-09-08T04:00:11.402Z"
  }
}
```

[Previous Read one tracker](https://www.shortsintel.com/docs/reference/trackers/get-tracker)[Next Stop tracking](https://www.shortsintel.com/docs/reference/trackers/delete-tracker)
