delete_secret
Remove a specific secret by its ID from a secret manager (Vault, AWS, or GCP) using the APISIX-MCP server to enhance security and data management.
Instructions
Delete a secret by ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | secret id | |
| manager | Yes | secret manager type |
Implementation Reference
- src/tools/secret.ts:30-32 (handler)Inline handler function for the 'delete_secret' tool. It calls makeAdminAPIRequest with DELETE method to remove the secret at `/secrets/{manager}/{id}`.
server.tool("delete_secret", "Delete a secret by ID", DeleteSecretSchema.shape, async (args) => { return await makeAdminAPIRequest(`/secrets/${args.manager}/${args.id}`, "DELETE"); }); - src/schemas/secret.ts:71-74 (schema)Zod input schema for 'delete_secret' tool requiring 'id' and 'manager' fields.
export const DeleteSecretSchema = z.object({ id: z.string().describe("secret id"), manager: SecretTypeSchema.describe("secret manager type"), }); - src/tools/secret.ts:30-32 (registration)Registration of the 'delete_secret' tool on the MCP server using server.tool().
server.tool("delete_secret", "Delete a secret by ID", DeleteSecretSchema.shape, async (args) => { return await makeAdminAPIRequest(`/secrets/${args.manager}/${args.id}`, "DELETE"); }); - src/utils/adminAPI.ts:11-80 (helper)Helper utility function used by the delete_secret handler to make HTTP requests to the admin API, including DELETE requests.
export async function makeAdminAPIRequest( path: string, method: string = "GET", data?: object ): Promise<CallToolResult> { const baseUrl = `${APISIX_SERVER_HOST}:${APISIX_ADMIN_API_PORT}${APISIX_ADMIN_API_PREFIX}`; const url = `${baseUrl}${path}`; try { const response = await axios({ method, url, data, headers: { "X-API-KEY": APISIX_ADMIN_KEY, "Content-Type": "application/json", }, }); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error) { if (axios.isAxiosError(error)) { console.error(`Request failed: ${method} ${url}`); console.error( `Status: ${error.response?.status}, Error: ${error.message}` ); if (error.response?.data) { try { const stringifiedData = JSON.stringify(error.response.data); console.error(`Response data: ${stringifiedData}`); } catch { console.error(`Response data: [Cannot parse as JSON]`); } } return { isError: true, content: [ { type: "text", text: JSON.stringify( `Status: ${error.response?.status}\nMessage: ${error.message} Data:\n${JSON.stringify(error.response?.data || {}, null, 2)}`, null, 2 ), }, ], }; } else { return { isError: true, content: [ { type: "text", text: JSON.stringify(error, null, 2), }, ], }; } } }