Documentation Index
Fetch the complete documentation index at: https://docs.tokencraft.dev/llms.txt
Use this file to discover all available pages before exploring further.
Delete Token
Permanently deletes a design token. This action cannot be undone.
Write access policy - This endpoint requires the write:tokens scope.
- TEAM-owned workspace:
owner, admin, editor can write; viewer is blocked (403).
- Non-TEAM workspace: only the workspace owner can write.
- If the workspace owner plan has no API write access (for example FREE), write is blocked.
Endpoint
DELETE /tokensets/{id}/modes/{modeId}/tokens/{tokenId}
Request
Path Parameters
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Tokenset ID |
modeId | string | Yes | Mode ID |
tokenId | string | Yes | Token ID |
Response
Status: 200 OK
{
"message": "Token deleted successfully"
}
Examples
curl -X DELETE https://app.tokencraft.dev/api/v1/tokensets/tokenset-123/modes/mode-light/tokens/token-123 \
-H "Authorization: Bearer tkc_your_token_here"
Error Responses
404 Not Found
{
"error": "Token not found"
}
This operation is irreversible. The token will be permanently deleted. Consider exporting your tokens before deletion.
Considerations
1. Alias Dependencies
If other tokens reference this token as an alias, they will break. Check for dependencies first:
async function safeDeleteToken(tokensetId, modeId, tokenId, tokenName) {
// Get all tokens
const { tokens } = await getTokens(tokensetId, modeId);
// Check for aliases
const aliases = tokens.filter(t => t.alias_to === tokenName);
if (aliases.length > 0) {
console.warn(`Warning: ${aliases.length} tokens reference this token`);
console.log('Aliases:', aliases.map(t => t.name));
// Option 1: Delete aliases first
for (const alias of aliases) {
await deleteToken(tokensetId, modeId, alias.id);
}
}
// Then delete the token
await deleteToken(tokensetId, modeId, tokenId);
}
2. Batch Deletion
Delete multiple tokens:
async function deleteTokens(tokensetId, modeId, tokenIds) {
for (const tokenId of tokenIds) {
await deleteToken(tokensetId, modeId, tokenId);
}
}
// Usage
await deleteTokens('tokenset-123', 'mode-light', [
'token-1',
'token-2',
'token-3'
]);
3. Export Before Deletion
async function exportAndDelete(tokensetId, modeId, tokenId) {
// Get token details first
const token = await getToken(tokensetId, modeId, tokenId);
// Save to backup
fs.writeFileSync(
`backup-${token.name}.json`,
JSON.stringify(token, null, 2)
);
// Then delete
await deleteToken(tokensetId, modeId, tokenId);
}
Recovery
Deleted tokens cannot be recovered. There is no undo or trash bin. Make sure you have backups of important tokens.
Next Steps
Create Token
Create a new token
Export Tokens
Export before deletion
