volume_delete
Delete unused storage volumes to optimize resource management and cleanup in Railway infrastructure. Ideal for permanent data removal after ensuring backups via volume_backup.
Instructions
[API] Delete a volume from a service
⚡️ Best for: ✓ Removing unused storage ✓ Storage cleanup ✓ Resource management
⚠️ Not for: × Temporary data removal × Data backup (use volume_backup first)
→ Prerequisites: volume_list
→ Related: service_update
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| volumeId | Yes | ID of the volume to delete |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"volumeId": {
"description": "ID of the volume to delete",
"type": "string"
}
},
"required": [
"volumeId"
],
"type": "object"
}
Implementation Reference
- src/tools/volume.tool.ts:97-99 (handler)The tool handler function that delegates volume deletion to the volumeService.return volumeService.deleteVolume(volumeId); } )
- src/tools/volume.tool.ts:94-96 (schema)Zod schema defining the input parameter 'volumeId' for the volume_delete tool.volumeId: z.string().describe("ID of the volume to delete") }, async ({ volumeId }) => {
- src/tools/volume.tool.ts:74-99 (registration)The createTool invocation that defines and registers the volume_delete tool with its name, description, input schema, and handler.createTool( "volume_delete", formatToolDescription({ type: 'API', description: "Delete a volume from a service", bestFor: [ "Removing unused storage", "Storage cleanup", "Resource management" ], notFor: [ "Temporary data removal", "Data backup (use volume_backup first)" ], relations: { prerequisites: ["volume_list"], related: ["service_update"] } }), { volumeId: z.string().describe("ID of the volume to delete") }, async ({ volumeId }) => { return volumeService.deleteVolume(volumeId); } )
- src/tools/index.ts:16-37 (registration)The registration function that adds all tools, including volume_delete via volumeTools, to the MCP server.export function registerAllTools(server: McpServer) { // Collect all tools const allTools = [ ...databaseTools, ...deploymentTools, ...domainTools, ...projectTools, ...serviceTools, ...tcpProxyTools, ...variableTools, ...configTools, ...volumeTools, ...templateTools, ] as Tool[]; // Register each tool with the server allTools.forEach((tool) => { server.tool( ...tool ); }); }
- Supporting service method that performs the volume deletion using the API client and formats the response.async deleteVolume(volumeId: string): Promise<CallToolResult> { try { const success = await this.client.volumes.deleteVolume(volumeId); if (success) { return createSuccessResponse({ text: "✅ Volume deleted successfully", data: { success } }); } else { return createErrorResponse("Failed to delete volume"); } } catch (error) { return createErrorResponse(`Error deleting volume: ${formatError(error)}`); } }