vs_alerts_list
Retrieve and filter organization alerts by status (unacknowledged, acknowledged, or resolved). Use pagination to navigate through results and manage alert workflows.
Instructions
List alerts for the authenticated organization. Filter by status (UNACKNOWLEDGED/ACKNOWLEDGED/RESOLVED) or paginate.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | UNACKNOWLEDGED, ACKNOWLEDGED, or RESOLVED. | |
| page | No | ||
| limit | No | Default 50, max 200. |
Implementation Reference
- src/tools.ts:338-345 (handler)The handler function for vs_alerts_list. It makes a GET request to /api/alerts with optional query parameters (status, page, limit).
handler: async (args, client) => client.request('GET', '/api/alerts', { query: { status: pickString(args, 'status'), page: pickNumber(args, 'page'), limit: pickNumber(args, 'limit'), }, }), - src/tools.ts:328-336 (schema)Input schema for vs_alerts_list: accepts optional status (string), page (integer), limit (integer) with additionalProperties disabled.
inputSchema: { type: 'object', properties: { status: { ...STR, description: 'UNACKNOWLEDGED, ACKNOWLEDGED, or RESOLVED.' }, page: { ...INT }, limit: { ...INT, description: 'Default 50, max 200.' }, }, additionalProperties: false, }, - src/tools.ts:324-346 (registration)Tool registration entry in the TOOLS array. The tool has name 'vs_alerts_list', requires authentication, and is wired to the handler.
{ name: 'vs_alerts_list', description: 'List alerts for the authenticated organization. Filter by status (UNACKNOWLEDGED/ACKNOWLEDGED/RESOLVED) or paginate.', inputSchema: { type: 'object', properties: { status: { ...STR, description: 'UNACKNOWLEDGED, ACKNOWLEDGED, or RESOLVED.' }, page: { ...INT }, limit: { ...INT, description: 'Default 50, max 200.' }, }, additionalProperties: false, }, requiresAuth: true, handler: async (args, client) => client.request('GET', '/api/alerts', { query: { status: pickString(args, 'status'), page: pickNumber(args, 'page'), limit: pickNumber(args, 'limit'), }, }), }, - src/tools.ts:32-33 (helper)Helper function pickString used to safely extract the optional 'status' argument from the input args.
function pickString(args: Record<string, unknown>, key: string): string | undefined { const v = args[key]; - src/tools.ts:37-39 (helper)Helper function pickNumber used to safely extract optional numeric arguments 'page' and 'limit' from the input args.
function pickNumber(args: Record<string, unknown>, key: string): number | undefined { const v = args[key]; return typeof v === 'number' && Number.isFinite(v) ? v : undefined;