delete_message
Delete specific messages in Webex using the message ID, ensuring precise content removal through the Webex MCP Server.
Instructions
Delete a message in Webex by message ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| messageId | Yes | The unique identifier for the message to be deleted. |
Implementation Reference
- The main handler function that executes the deletion of a Webex message by making a DELETE request to the `/messages/{messageId}` endpoint using Webex configuration utilities.
const executeFunction = async ({ messageId }) => { try { // Construct the URL for the delete request const url = getWebexUrl(`/messages/${encodeURIComponent(messageId)}`); // Set up headers for the request const headers = getWebexHeaders(); // Perform the fetch request const response = await fetch(url, { method: 'DELETE', headers }); // Check if the response was successful if (!response.ok) { const errorData = await response.json(); throw new Error(JSON.stringify(errorData)); } // Return the response status return { status: response.status, message: 'Message deleted successfully.' }; } catch (error) { console.error('Error deleting message:', error); return { error: error.message || 'An error occurred while deleting the message.', details: error.stack }; } }; - The apiTool export that registers the 'delete_message' tool, linking the handler function to its schema definition for MCP integration.
const apiTool = { function: executeFunction, definition: { type: 'function', function: { name: 'delete_message', description: 'Delete a message in Webex by message ID.', parameters: { type: 'object', properties: { messageId: { type: 'string', description: 'The unique identifier for the message to be deleted.' } }, required: ['messageId'] } } } }; - JSON schema defining the input parameters for the delete_message tool: an object requiring 'messageId' as a string.
parameters: { type: 'object', properties: { messageId: { type: 'string', description: 'The unique identifier for the message to be deleted.' } }, required: ['messageId'] }