get_notifications
Retrieve Backlog notifications with customizable filters for ID range, count, and sort order to manage project updates.
Instructions
Returns list of notifications
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| minId | No | Minimum notification ID | |
| maxId | No | Maximum notification ID | |
| count | No | Number of notifications to retrieve | |
| order | No | Sort order |
Implementation Reference
- src/tools/getNotifications.ts:43-49 (handler)The handler function that implements the core logic of the 'get_notifications' tool by invoking the Backlog SDK's getNotifications method with destructured input parameters.handler: async ({ minId, maxId, count, order }) => backlog.getNotifications({ minId, maxId, count, order, }),
- src/tools/getNotifications.ts:7-26 (schema)Zod-based input schema definition for the 'get_notifications' tool, including optional parameters for minId, maxId, count, and order.const getNotificationsSchema = buildToolSchema((t) => ({ minId: z .number() .optional() .describe(t('TOOL_GET_NOTIFICATIONS_MIN_ID', 'Minimum notification ID')), maxId: z .number() .optional() .describe(t('TOOL_GET_NOTIFICATIONS_MAX_ID', 'Maximum notification ID')), count: z .number() .optional() .describe( t('TOOL_GET_NOTIFICATIONS_COUNT', 'Number of notifications to retrieve') ), order: z .enum(['asc', 'desc']) .optional() .describe(t('TOOL_GET_NOTIFICATIONS_ORDER', 'Sort order')), }));
- src/tools/tools.ts:157-167 (registration)Registration of the 'get_notifications' tool within the 'notifications' toolset group in the allTools function.{ name: 'notifications', description: 'Tools for managing user notifications.', enabled: false, tools: [ getNotificationsTool(backlog, helper), getNotificationsCountTool(backlog, helper), resetUnreadNotificationCountTool(backlog, helper), markNotificationAsReadTool(backlog, helper), ], },
- src/tools/getNotifications.ts:35-51 (schema)Tool definition block including name, description, input/output schemas, and handler for 'get_notifications'.return { name: 'get_notifications', description: t( 'TOOL_GET_NOTIFICATIONS_DESCRIPTION', 'Returns list of notifications' ), schema: z.object(getNotificationsSchema(t)), outputSchema: NotificationSchema, handler: async ({ minId, maxId, count, order }) => backlog.getNotifications({ minId, maxId, count, order, }), }; };