project_delete
Delete a Railway project and all associated resources permanently. Use this tool to remove unused projects or clean up test environments.
Instructions
[API] Delete a Railway project and all its resources
⚡️ Best for: ✓ Removing unused projects ✓ Cleaning up test projects
⚠️ Not for: × Temporary project deactivation × Service-level cleanup (use service_delete)
→ Prerequisites: project_list, project_info
→ Alternatives: service_delete
→ Related: project_create
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | ID of the project to delete |
Implementation Reference
- src/tools/project.tool.ts:82-107 (registration)Tool registration for 'project_delete', including schema (projectId: string) and thin handler delegating to projectService
createTool( "project_delete", formatToolDescription({ type: 'API', description: "Delete a Railway project and all its resources", bestFor: [ "Removing unused projects", "Cleaning up test projects", ], notFor: [ "Temporary project deactivation", "Service-level cleanup (use service_delete)" ], relations: { prerequisites: ["project_list", "project_info"], alternatives: ["service_delete"], related: ["project_create"] } }), { projectId: z.string().describe("ID of the project to delete") }, async ({ projectId }) => { return projectService.deleteProject(projectId); } ), - src/services/project.service.ts:96-105 (handler)Core handler for project deletion in ProjectService, executes API call and formats response
async deleteProject(projectId: string): Promise<CallToolResult> { try { await this.client.projects.deleteProject(projectId); return createSuccessResponse({ text: "Project deleted successfully" }); } catch (error) { return createErrorResponse(`Error deleting project: ${formatError(error)}`); } } - Repository helper executing GraphQL mutation to delete project via Railway API
async deleteProject(projectId: string): Promise<void> { await this.client.request<{ projectDelete: boolean }>(` mutation projectDelete($projectId: String!) { projectDelete(id: $projectId) } `, { projectId }); }