> ## Documentation Index
> Fetch the complete documentation index at: https://docs.freshtalent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring

> Feed, Timeline, and Alerts — review profile changes and configure when to get notified.

**Monitoring** is the dashboard page (`/dash/explore/monitoring`). Subtitle in the app: *Daily changes across tracked people.*

Each row is a profile diff: someone left Palantir, flipped Open to work, joined Anduril.

## Two different scopes

| Surface                        | Who is included                                                                                                             |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Monitoring** feed / Timeline | People on a [List](/guides/lists) **or** **Monitored** on a [Target](/guides/targets). Pending Approval and Removed do not. |
| `GET /events`                  | Same membership as the feed.                                                                                                |
| **Monitoring → Alerts**        | Each rule selects its audience and filters. The default is people you keep; a rule can also watch the whole graph.          |

Empty Monitoring means nobody is on a List and nobody is Monitored yet. Empty email does not mean the same thing.

## The dashboard

| Control                                 | What it does                                                                                               |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Feed** / **Timeline** / **Alerts**    | Review people, explore the same diffs over time, or manage alert rules. Timeline zoom: Day / Week / Month. |
| **30d / 60d / 90d**                     | Window.                                                                                                    |
| Search filters                          | Same token bar as Search, including certification name or issuing-authority substring.                     |
| **Saved list**                          | Restrict the feed to one List.                                                                             |
| Open to work / Between roles chips      | Availability.                                                                                              |
| Job moves / back at work / text updates | Triage. Counts only show when that kind exists in the window.                                              |
| **Mark all seen**                       | Clears the unread badge.                                                                                   |
| **Clear all**                           | Drops filters.                                                                                             |
| **Alert on this view**                  | Create an alert with the current filters and selected list.                                                |
| Slack link                              | Open Alerts to configure delivery. Connect the shared Slack workspace in Settings → Integrations.          |

## What the app calls the fields

Monitoring → **Alerts** → create or edit a rule. The Monitoring feed groups left/joined as **Current company**.

| Alert changes    | Monitoring feed  | API `field`        |
| ---------------- | ---------------- | ------------------ |
| Open to work     | Open to work     | `open_to_work`     |
| Between roles    | Between roles    | `between_roles`    |
| Left company     | Current company  | `left_company`     |
| Joined company   | Current company  | `joined_company`   |
| Removed role     | Removed role     | `removed_position` |
| Headline         | Headline         | `headline`         |
| About            | About            | `about`            |
| Role description | Role description | `role_description` |

## Where they go

| Channel              | Where in the app                                                         |
| -------------------- | ------------------------------------------------------------------------ |
| **Monitoring**       | Sidebar. Feed or Timeline.                                               |
| Email                | Monitoring → Alerts → select recipients on the rule.                     |
| Slack                | Connect in Settings → Integrations, then choose a channel on each alert. |
| ATS / CRM / outreach | Poll [GET /events](/api-reference/events/list).                          |

Store shared webhook defaults under Settings → Integrations. Storing a URL alone does not enable delivery; choose destinations on each alert. For polling integrations, use the events API.

## Recruiter setup

1. Accept people on [Targets](/guides/targets) and/or add them to [Lists](/guides/lists) — otherwise the Monitoring feed is empty.
2. Monitoring → Alerts → **New alert** → choose the audience and changes, such as Open to work, Left company, or Between roles.
3. Add email recipients or select a Slack channel. A whole-graph audience can include people outside your Lists and Targets.
4. Open **Monitoring** to read the feed.

## Integrator setup

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl \
  --get "https://api.freshtalent.ai/v1/events" \
  --data-urlencode "since=24h" \
  --data-urlencode "type=left_company" \
  -H "Authorization: Bearer $FRESHTALENT_API_KEY"
```

`since` accepts ISO-8601 or relative windows: `30m`, `24h`, `7d`, `2w`. Paginate with `meta.next` as `cursor`.

Each row:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "…",
  "field": "left_company",
  "before": "Palantir",
  "after": "Anduril",
  "seen_at": "2026-08-23T10:00:00.000Z",
  "severity": "hot",
  "label": "Left Palantir → Anduril",
  "person": {
    "slug": "derek-morrow",
    "name": "Derek Morrow",
    "linkedin_url": "https://www.linkedin.com/in/derek-morrow",
    "current_company": "Anduril"
  }
}
```

Map `person.linkedin_url` to the ATS candidate. Full sync: [ATS & CRM](/connect/ats-crm).