delete_attachment

Remove an attachment from a BookStack wiki by specifying its ID to manage content and maintain organized documentation.

Instructions

Delete an attachment

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	Attachment ID

Implementation Reference

src/tools/search-user-tools.ts:485-489 (handler)
Executes the 'delete_attachment' MCP tool: parses the attachment ID from input arguments, invokes the BookStack client's deleteAttachment method, and returns a success message.
```
case "delete_attachment": {
  const id = parseInteger(args.id);
  await client.deleteAttachment(id);
  return `Attachment ${id} deleted successfully`;
}
```

src/tools/search-user-tools.ts:264-274 (schema)

Tool schema definition specifying the name, description, and input schema (requiring a numeric 'id' for the attachment).

{
  name: "delete_attachment",
  description: "Delete an attachment",
  inputSchema: {
    type: "object",
    properties: {
      id: { type: "number", description: "Attachment ID" },
    },
    required: ["id"],
  },
},

src/lib/bookstack-client.ts:360-362 (helper)
BookStackClient helper method that performs the actual HTTP DELETE request to the BookStack API endpoint `/attachments/{id}`.
```
async deleteAttachment(id: number): Promise<void> {
  return this.delete(`/attachments/${id}`);
}
```

src/index.ts:102-128 (registration)

Registers 'delete_attachment' in the searchUserToolNames array for dispatch routing to the appropriate handler (handleSearchAndUserTool) in the MCP server's CallToolRequestSchema handler.

// Search and user tools
const searchUserToolNames = [
  "search_all",
  "list_users",
  "get_user",
  "create_user",
  "update_user",
  "delete_user",
  "list_roles",
  "get_role",
  "create_role",
  "update_role",
  "delete_role",
  "list_attachments",
  "get_attachment",
  "delete_attachment",
  "list_images",
  "get_image",
  "update_image",
  "delete_image",
];

if (contentToolNames.includes(name)) {
  result = await handleContentTool(name, args, bookStackClient);
} else if (searchUserToolNames.includes(name)) {
  result = await handleSearchAndUserTool(name, args, bookStackClient);
} else {

src/index.ts:56-66 (registration)

Includes the 'delete_attachment' tool (via createSearchAndUserTools) in the allTools array advertised to MCP clients via ListToolsRequestSchema.

const allTools: Tool[] = [
  ...createContentTools(bookStackClient),
  ...createSearchAndUserTools(bookStackClient),
];

// List tools handler
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: allTools,
  };
});

BookStack MCP Server