delete_access_token
Removes a specific access token from your Storyblok space to manage API access.
Instructions
Delete an access token from the current Storyblok space using the Management API.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"token_id": "<token_id>"
},
"name": "delete_access_token"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token_id | Yes | The ID of the access token to delete |
Implementation Reference
- src/tools/access-tokens.ts:139-176 (handler)The 'delete_access_token' tool handler: registers an MCP tool that accepts a token_id parameter, builds a DELETE request URL to /api_keys/{token_id}, calls the Storyblok Management API, and returns success (204) or failure responses.
// Tool: delete_access_token server.tool( 'delete_access_token', 'Delete an access token from the current Storyblok space using the Management API.', { token_id: z.number().describe('The ID of the access token to delete'), }, async ({ token_id }) => { try { const url = buildManagementUrl(`/api_keys/${token_id}`); const response = await fetch(url, { method: 'DELETE', headers: getManagementHeaders(), }); if (response.status === 204) { return { content: [{ type: 'text' as const, text: 'Access Token deleted successfully.' }], }; } else { return { isError: true, content: [ { type: 'text' as const, text: `Failed to delete Access token. Status code: ${response.status}`, }, ], }; } } catch (error) { if (error instanceof APIError) { return createErrorResponse(error); } throw error; } } ); - src/tools/access-tokens.ts:143-144 (schema)The Zod schema for the 'delete_access_token' tool: the only input parameter is token_id, a required number.
{ token_id: z.number().describe('The ID of the access token to delete'), - src/tools/index.ts:52-52 (registration)Registration of all access token tools (including delete_access_token) via registerAccessTokens(server) in the tool aggregator.
registerAccessTokens(server); - src/tools/access-tokens.ts:16-16 (registration)The export function registerAccessTokens that registers all access token tools on the MCP server.
export function registerAccessTokens(server: McpServer): void { - src/utils/api.ts:118-120 (helper)The buildManagementUrl helper used to construct the DELETE request URL for the delete_access_token handler.
export function buildManagementUrl(path: string): string { return `${API_ENDPOINTS.MANAGEMENT}/spaces/${cfg.spaceId}${path}`; }