Skip to main content

​
Route Configuration Guide

Learn how to configure routes with custom headers, method filtering, and environment-specific settings.

​
HTTP Methods

Control which HTTP methods are allowed:

​
Allow All Methods

By default, all methods (GET, POST, PUT, PATCH, DELETE) are allowed.

​
Restrict Methods

  1. Edit your route
  2. Under Allowed Methods, uncheck methods you want to block
  3. Example: Only allow GET and POST
Use case: Prevent clients from deleting data (block DELETE)

​
Header Injection

Add custom headers to requests sent to your backend:

​
Example: Add API Key

{
  "X-API-Key": "your-backend-api-key",
  "X-Source": "knoxcall"
}

​
Example: Add Authentication

{
  "Authorization": "Bearer {{stripe_api_key}}",
  "X-Environment": "production"
}
Use {{secret_name}} to inject secrets

​
Body Injection

Add data to the request body:

​
Example: Add Tenant ID

{
  "tenant_id": "12345",
  "source": "knoxcall"
}
Note: Only works with POST, PUT, PATCH requests

​
Path Rewriting

Transform the request path before forwarding: Client requests: 
/api/v1/users/123
Forwarded as: 
/users/123
The /api/v1 prefix is automatically removed.

​
Environment Configuration

Set different target URLs per environment:
  1. Edit route
  2. Scroll to Environment Configuration
  3. For each environment:
    • Development: http://localhost:3000
    • Staging: https://staging-api.example.com
    • Production: https://api.example.com
Clients specify environment via header: 
X-Environment: production

​
Rate Limiting

Limit requests per client:
  1. Enable Rate Limiting
  2. Set limits:
    • Requests: 100
    • Window: 60 (seconds)
    • Burst: 120
This allows 100 requests per minute, with bursts up to 120.

​
Timeout Settings

Default timeout is 30 seconds. Contact support to adjust.

​
Testing Configuration

After making changes:
  1. Click Test Route
  2. Select environment
  3. Enter sample request
  4. View response

​
Need More Help?

  • See the Quick Start Guide for basics
  • Learn about secrets for secure credential injection
  • Check troubleshooting guides for common issues

📊 Statistics

  • Views: 1
  • Helpful: 0 👍
  • Level: intermediate

🏷️ Tags

routes, configuration, intermediate