Skip to main content
GET
Get a Discord watch monitor

Authorizations

Authorization
string
header
required

Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>. Keys carry a scope — read, write (implies read) or admin (implies write) — chosen when the key is minted. Each operation's security requirement (and its x-required-scope extension) names the minimum scope it needs; request the least-privileged key that covers the operations you call.

Path Parameters

id
integer
required

The watch monitor id.

Required range: x <= 9007199254740991
Example:

34

Response

200 response

id
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
Required range: -9007199254740991 <= x <= 9007199254740991
guildId
string
required

A Discord snowflake id as a decimal string (64-bit — never parse it as a number).

Pattern: ^\d{1,20}$
Example:

"1290000000000000200"

keywordId
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
channelIds
string[]
required

Watched channel ids; [] = every channel the server link reads.

A Discord snowflake id as a decimal string (64-bit — never parse it as a number).

Pattern: ^\d{1,20}$
status
enum<string>
required

paused: paused by an admin. paused_bot_removed: waits for the bot to be re-added to the server, then resumes on its own.

Available options:
active,
paused,
paused_bot_removed
dailyCap
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
todayCount
integer
required

Posts created so far this UTC day.

Required range: -9007199254740991 <= x <= 9007199254740991
lastErrorCode
string | null
required

e.g. missing_access when the bot can read none of the watched channels.

estimatedMonthlyMentions
integer | null
required

Expected mentions per month at this monitor's cap; null = unknown (no stats yet).

Required range: -9007199254740991 <= x <= 9007199254740991
createdAt
string
required
Example:

"2026-10-28T12:00:00.000Z"

updatedAt
string
required
Example:

"2026-10-28T12:00:00.000Z"