Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.knoxcall.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Create Route

POST /v1/routes
Creates a new route in your tenant.

​
Request Body

FieldTypeRequiredDescription
namestringYesDisplay name for the route
target_base_urlstringYesThe upstream API base URL to proxy requests to
base_environmentstringNoDefault environment (defaults to production)
inject_headers_jsonobjectNoHeaders to inject into proxied requests
inject_body_jsonobjectNoBody fields to inject into proxied requests
injection_rulesobject[]NoAdvanced injection rules for secrets
ip_allowliststring[]NoIP addresses or CIDR ranges allowed to call this route
method_configsobjectNoPer-HTTP-method configuration overrides
collection_idstringNoAssign to a collection

​
Response

Returns the created route object (same shape as Get Route). 
curl -X POST https://api.knoxcall.com/v1/routes \
  -H "Authorization: Bearer tk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Payment Gateway",
    "target_base_url": "https://api.stripe.com/v1"
  }'

​
Errors

StatusTypeDescription
400validation_errorMissing required fields or invalid environment
403plan_limitRoute limit reached for your subscription plan
409conflictA route with this name already exists