---
title: "Change the monitoring period or relevance level, pause or resume (scope write:intelligence)"
method: PATCH
path: "/api/v1/intelligence/monitoring/{id}"
tags: ["v1"]
---

# Change the monitoring period or relevance level, pause or resume (scope write:intelligence)

`PATCH /api/v1/intelligence/monitoring/{id}`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/v1/intelligence/monitoring/{id}`
- Auth: HTTP bearer

A new periodDays runs from today. admitLevel 2 | 3 changes what counts as a signal from the next check: 2 stated needs only, 3 also topic interest (professional content about your space with no stated need, delivered as topic-interest signals from strength 5). isActive false pauses the weekly checks (nothing is charged); true resumes them, and resuming an ended monitor starts a fresh period of the same length.

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateMonitoringBody
  - `periodDays` union: 30, 90 or 180 days; null means forever.
    - 30
    - 90
    - 180
  - `isActive` boolean
  - `admitLevel` union: 2 (default): stated needs only — the person's activity becomes a signal when its text states a need, pain or buying moment your product addresses. 3: also topic interest — professional content about your category with no stated need, delivered as topic-interest signals with a lower strength floor (5 instead of 8).
    - 2
    - 3

## Response `200`

Updated monitored person

- V1MonitoredPersonResponse
  - `data` V1MonitoredPerson, required
    - `id` string, required
    - `linkedinUrl` string, required
    - `slug` string, required
    - `displayName` string, nullable, required
    - `isActive` boolean, required
    - `inactiveReason` string, nullable, required: 'paused', 'removed', 'monitoring_ended' or 'plan_cap' when inactive; null while active.
    - `createdAt` string, required
    - `lastCheckedAt` string, nullable, required: When the last weekly check ran; null before the first.
    - `monitoring` object, nullable, required: The monitoring period and relevance level (2 stated needs only, 3 also topic interest; since 2026-10-17); null on rows that predate periods (monitored with no end date, level 2).
      - `periodDays` union, required: 30, 90 or 180 days; null means forever.
        - 30
        - 90
        - 180
      - `startedAt` string, nullable, required
      - `until` string, nullable, required
      - `endsInDays` integer, nullable, required
      - `ended` boolean, required
      - `admitLevel` union, required: 2 (default): stated needs only — the person's activity becomes a signal when its text states a need, pain or buying moment your product addresses. 3: also topic interest — professional content about your category with no stated need, delivered as topic-interest signals with a lower strength floor (5 instead of 8).
        - 2
        - 3
    - `person` object, nullable, required
      - `fullName` string, nullable, required
      - `headline` string, nullable, required
      - `currentTitle` string, nullable, required
      - `currentCompany` string, nullable, required
    - `signals` object, required
      - `last30` integer, required
      - `last90` integer, required
      - `total` integer, required
    - `latestSnapshotId` string, nullable, required: Newest Person Intelligence snapshot for this person, readable at /api/v1/intelligence/people/{id}.
  - `_meta` V1Meta, required
    - `mode` 'live' | 'sample', required
    - `notice` string
    - `cta` object
      - `text` string, required
      - `url` string, required

## Other responses

- `400`: Validation error
- `403`: Insufficient scope or inactive workspace
- `404`: Not found

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)