Skip to content

Delete Routing Rule

Delete Routing Rule

Permanently deletes a routing rule. This action cannot be undone.

Endpoint

DELETE /v1/routing-rules/{id}

Path Parameters

Parameter	Type	Required	Description
`id`	integer	Yes	The routing rule ID

Examples

import Tokenrouter from 'tokenrouter';

const client = new Tokenrouter({
  apiKey: process.env.TOKENROUTER_API_KEY
});

await client.routingRules.delete(123);

console.log('Rule deleted successfully');

from tokenrouter import Tokenrouter

client = Tokenrouter(
    api_key=os.getenv("TOKENROUTER_API_KEY")
)

client.routing_rules.delete(123)

print("Rule deleted successfully")

curl -X DELETE https://api.tokenrouter.io/v1/routing-rules/123 \
  -H "Authorization: Bearer tr_..."

Response

{
  "success": true
}

Error Responses

403 Forbidden - Free Plan

{
  "error": {
    "message": "Routing rules are not available on the free plan",
    "type": "authorization_error",
    "http_status": 403
  }
}

404 Not Found

{
  "error": {
    "message": "Routing rule not found",
    "type": "not_found_error",
    "http_status": 404
  }
}

Safe Deletion Pattern

Always verify before deleting:

TypeScript
Python

// Get rule details first
const rule = await client.routingRules.retrieve(ruleId);

console.log(`About to delete: ${rule.data.name}`);
console.log(`Priority: ${rule.data.priority}`);

// Confirm deletion
const confirmed = confirm('Delete this rule?');

if (confirmed) {
  await client.routingRules.delete(ruleId);
  console.log('Rule deleted');
}

# Get rule details first
rule = client.routing_rules.retrieve(rule_id)

print(f"About to delete: {rule.data.name}")
print(f"Priority: {rule.data.priority}")

# Confirm deletion
confirmed = input("Delete this rule? (y/n): ").lower() == 'y'

if confirmed:
    client.routing_rules.delete(rule_id)
    print("Rule deleted")

Bulk Deletion

Delete multiple rules:

TypeScript
Python

// Delete all disabled rules
const rules = await client.routingRules.list();

const disabledRules = rules.data.filter(r => !r.is_enabled);

for (const rule of disabledRules) {
  await client.routingRules.delete(rule.id);
  console.log(`Deleted: ${rule.name}`);
}

# Delete all disabled rules
rules = client.routing_rules.list()

disabled_rules = [r for r in rules.data if not r.is_enabled]

for rule in disabled_rules:
    client.routing_rules.delete(rule.id)
    print(f"Deleted: {rule.name}")

Delete with Backup

Save rule before deleting:

TypeScript
Python

// Backup rule before deleting
const rule = await client.routingRules.retrieve(ruleId);

const backup = {
  name: rule.data.name,
  priority: rule.data.priority,
  is_enabled: rule.data.is_enabled,
  match_json: rule.data.match_json,
  action_json: rule.data.action_json
};

// Save to file/database
console.log('Backup:', JSON.stringify(backup, null, 2));

// Delete
await client.routingRules.delete(ruleId);

import json

# Backup rule before deleting
rule = client.routing_rules.retrieve(rule_id)

backup = {
    "name": rule.data.name,
    "priority": rule.data.priority,
    "is_enabled": rule.data.is_enabled,
    "match_json": rule.data.match_json,
    "action_json": rule.data.action_json
}

# Save to file/database
print("Backup:", json.dumps(backup, indent=2))

# Delete
client.routing_rules.delete(rule_id)

Alternative: Disable Instead

Consider disabling rules instead of deleting:

TypeScript
Python

// Instead of deleting, disable the rule
await client.routingRules.update(ruleId, {
  is_enabled: false
});

// Can be re-enabled later if needed
await client.routingRules.update(ruleId, {
  is_enabled: true
});

# Instead of deleting, disable the rule
client.routing_rules.update(rule_id, is_enabled=False)

# Can be re-enabled later if needed
client.routing_rules.update(rule_id, is_enabled=True)

When to Delete vs Disable

Scenario	Recommendation
Testing a rule	Disable it
Seasonal rule (e.g., holiday promotions)	Disable it
Temporary override	Disable it
Deprecated provider	Delete it
Duplicate rule	Delete it
Experimental rule that failed	Delete it

Best Practices

Always get rule details before deleting
Backup important rules before deletion
Prefer disabling over deleting when unsure
Delete in batches carefully to avoid accidents
Document deletion reasons in your change log

Next Steps