---
title: "Check the helpdesk for new mentions now"
method: POST
path: "/ServiceDesk/Mentions/Sweep"
tags: ["Servicedesk"]
---

# Check the helpdesk for new mentions now

`POST /ServiceDesk/Mentions/Sweep`

## Request

- Base URL: `https://api.tonbridge.school`
- URL: `https://api.tonbridge.school/ServiceDesk/Mentions/Sweep`
- Auth: HTTP bearer

**Requires permission:** *IT*

Runs one pass of the mention sweep and reports what it found. The sweep no longer runs on a timer — it was the largest consumer of the Freshservice rate limit the whole School shares — so this is what makes new mentions appear. A pass is bounded by a time budget and by the rate limit, so a long backfill is worked through over several presses rather than in one request.

## Response `200`

Success - Sweep ran

- PostServiceDeskMentionSweepResponse
  - `examined` integer
  - `recorded` integer
  - `remaining` integer
  - `throttled` boolean
  - `watermarkUtc` string, date-time, nullable
  - `error` string, nullable
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-09-15** `c3198d2b5197`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/changes/ServiceDesk/Mentions/Sweep/post.md)

---

[API](https://skmtc.dev/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/revisions/d7f60d54b9de?raw)
