search_cases_by_user
Find Cisco support cases by user IDs to track ownership and involvement. Filter by status, date range, and sort results for case management.
Instructions
Search for cases associated with specific user IDs (max 10). Returns cases owned by or involving the specified users.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_ids | Yes | Comma-separated list of user IDs (max 10) | |
| status_flag | No | Return only cases associated with the specified status; O = open, C = closed. If status_flag is O (open), all open cases within the specified date range are returned; if a date range is not specified, all open cases associated with the other search parameters are returned. The maximum range returned is 90 days. The default behavior for this parameter is to return cases of both open and closed status. | |
| date_created_from | No | Beginning date (in UTC) of the range in which to search. For example: 2013-04-23T11:00:14Z Note: The maximum date range currently supported is 90 days. | |
| date_created_to | No | End date (in UTC) of the range in which to search. For example: 2013-04-23T11:00:00Z Note: The maximum date range currently supported is 90 days. | |
| sort_by | No | Sort results by field. UPDATED_DATE: Sort by last modification time (ascending). Default. STATUS: Sort by status (ascending) | UPDATED_DATE |
| page_index | No | Page number for pagination (default: 5) |
Implementation Reference
- src/apis/case-api.ts:161-169 (handler)The executeTool handler logic specifically for 'search_cases_by_user'. Constructs the API endpoint using user_ids and appends optional query parameters (status_flag, date_created_from/to, sort_by, page_index). Calls the shared makeApiCall method to execute the Cisco Case API request.case 'search_cases_by_user': endpoint = `/cases/users/user_ids/${encodeURIComponent(processedArgs.user_ids)}`; // Add all optional parameters with defaults if (processedArgs.status_flag) apiParams.status_flag = processedArgs.status_flag; if (processedArgs.date_created_from) apiParams.date_created_from = processedArgs.date_created_from; if (processedArgs.date_created_to) apiParams.date_created_to = processedArgs.date_created_to; apiParams.sort_by = processedArgs.sort_by || 'UPDATED_DATE'; apiParams.page_index = processedArgs.page_index || 5; break;
- src/apis/case-api.ts:90-131 (schema)Input schema and metadata (name, description) for the search_cases_by_user tool, returned by CaseApi.getTools() for MCP tool discovery.{ name: 'search_cases_by_user', description: 'Search for cases associated with specific user IDs (max 10). Returns cases owned by or involving the specified users.', inputSchema: { type: 'object', properties: { user_ids: { type: 'string', description: 'Comma-separated list of user IDs (max 10)', pattern: '^[A-Za-z0-9@.,\\s\\-]+$' }, status_flag: { type: 'string', description: 'Return only cases associated with the specified status; O = open, C = closed. If status_flag is O (open), all open cases within the specified date range are returned; if a date range is not specified, all open cases associated with the other search parameters are returned. The maximum range returned is 90 days. The default behavior for this parameter is to return cases of both open and closed status.', enum: ['O', 'C'] }, date_created_from: { type: 'string', description: 'Beginning date (in UTC) of the range in which to search. For example: 2013-04-23T11:00:14Z Note: The maximum date range currently supported is 90 days.', pattern: '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$' }, date_created_to: { type: 'string', description: 'End date (in UTC) of the range in which to search. For example: 2013-04-23T11:00:00Z Note: The maximum date range currently supported is 90 days.', pattern: '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$' }, sort_by: { type: 'string', description: 'Sort results by field. UPDATED_DATE: Sort by last modification time (ascending). Default. STATUS: Sort by status (ascending)', enum: ['STATUS', 'SEVERITY', 'CREATED_DATE', 'MODIFIED_DATE', 'UPDATED_DATE'], default: 'UPDATED_DATE' }, page_index: { type: 'integer', description: 'Page number for pagination (default: 5)', minimum: 1, default: 5 } }, required: ['user_ids'] } }
- src/apis/index.ts:103-103 (registration)Registration of CaseApi instance in ApiRegistry at 'case' key. This enables getAvailableTools() to include search_cases_by_user via CaseApi.getTools(), and executeTool() to route calls to CaseApi.executeTool.this.apis.set('case', new CaseApi());