delete-query
Delete a saved query by UUID with optional hard delete for permanent removal.
Instructions
Delete a saved query by UUID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Query UUID to delete | |
| hardDelete | No | Hard delete (permanent) vs soft delete |
Implementation Reference
- src/tools/queries.ts:69-74 (handler)The handler function for 'delete-query'. Calls assertWriteAllowed() and then sends a DELETE request to /queries/:id with an optional hardDelete parameter.
export async function deleteQuery(params: z.infer<typeof deleteQuerySchema>) { assertWriteAllowed(); return omClient.delete(`/queries/${params.id}`, { hardDelete: params.hardDelete, }); } - src/tools/queries.ts:64-67 (schema)Zod schema for 'delete-query' input validation. Requires id (string UUID) and optional hardDelete (boolean, default false).
export const deleteQuerySchema = z.object({ id: z.string().describe("Query UUID to delete"), hardDelete: z.boolean().optional().default(false).describe("Hard delete (permanent) vs soft delete"), }); - src/index.ts:405-405 (registration)Registration of the 'delete-query' tool with the MCP server, using deleteQuerySchema for input shape and wrapToolHandler(deleteQuery) as handler.
tool("delete-query", "Delete a saved query by UUID", deleteQuerySchema.shape, wrapToolHandler(deleteQuery)); - src/client.ts:98-100 (helper)The omClient.delete method used by the deleteQuery handler. Sends an HTTP DELETE with query params.
async delete<T = unknown>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> { return this.request<T>("DELETE", path, { params }); } - src/tools/utils.ts:12-16 (helper)The assertWriteAllowed helper used in the deleteQuery handler to guard against write operations when writes are disabled.
export function assertWriteAllowed(): void { if (!config.allowWrite) { throw new WriteBlockedError(); } }