delete_asset_folder
Delete an asset folder from your Storyblok space by providing its folder ID. Removes the folder and its contents permanently.
Instructions
Delete an asset folder from the current Storyblok space.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_id | Yes | ID of the folder to delete |
Implementation Reference
- src/tools/assets-folder.ts:128-146 (handler)The 'delete_asset_folder' tool handler that takes a folder_id parameter and calls the Storyblok Management API DELETE endpoint /asset_folders/{folder_id}.
// Tool: delete_asset_folder server.tool( 'delete_asset_folder', 'Delete an asset folder from the current Storyblok space.', { folder_id: z.string().describe('ID of the folder to delete'), }, async ({ folder_id }) => { try { const data = await apiDelete(`/asset_folders/${folder_id}`); return createJsonResponse(data); } catch (error) { if (error instanceof APIError) { return createErrorResponse(error); } throw error; } } ); - src/tools/assets-folder.ts:132-134 (schema)The input schema for delete_asset_folder - expects a single 'folder_id' string parameter describing the ID of the folder to delete.
{ folder_id: z.string().describe('ID of the folder to delete'), }, - src/tools/index.ts:93-93 (registration)Registration of the registerAssetsFolders function (which registers delete_asset_folder) in the main tool aggregator.
registerAssetsFolders(server); - src/tools/assets-folder.ts:10-10 (registration)The registerAssetsFolders function exported from assets-folder.ts that registers all asset folder tools including delete_asset_folder.
export function registerAssetsFolders(server: McpServer): void { - src/utils/api.ts:227-234 (helper)The apiDelete helper function used by delete_asset_folder to make the DELETE HTTP request to the Storyblok Management API.
export async function apiDelete<T = unknown>(path: string): Promise<T> { const url = buildManagementUrl(path); const response = await fetch(url, { method: 'DELETE', headers: getManagementHeaders(), }); return handleResponse<T>(response, url); }