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.
List Route Environments
GET /v1/routes/:id/environments
Returns all environment-specific configuration overrides for a route.
Path Parameters
| Parameter | Type | Description |
|---|
id | uuid | The route ID |
Response
{
"data": [
{
"environment_name": "staging",
"target_base_url": "https://api-staging.stripe.com/v1",
"inject_headers_json": {},
"inject_body_json": {},
"require_signature": false,
"signature_tolerance_sec": null,
"rate_limit_enabled": false,
"rate_limit_requests": null,
"rate_limit_window_sec": null,
"rate_limit_burst": null,
"allowed_methods": null
}
],
"meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}
Errors
| Status | Type | Description |
|---|
| 404 | not_found | Route not found |
Set Route Environment Override
PUT /v1/routes/:id/environments/:env
Creates or replaces the environment-specific configuration for a route. This lets you point the same route at a different upstream URL, inject different headers, or apply different rate limits per environment.
Path Parameters
| Parameter | Type | Description |
|---|
id | uuid | The route ID |
env | string | Environment name (e.g., staging, development) |
Request Body
All fields are optional. Only provided fields will override the base route configuration for this environment.
| Field | Type | Description |
|---|
target_base_url | string | Override upstream URL |
inject_headers_json | object | Override injected headers |
inject_body_json | object | Override injected body fields |
require_signature | boolean | Override signature requirement |
signature_tolerance_sec | number | Override signature tolerance |
rate_limit_enabled | boolean | Override rate limiting |
rate_limit_requests | number | Override max requests |
rate_limit_window_sec | number | Override window duration |
rate_limit_burst | number | Override burst allowance |
allowed_methods | string[] | Override allowed HTTP methods |
Response
Returns the environment config object.
Errors
| Status | Type | Description |
|---|
| 400 | validation_error | Invalid environment name |
| 404 | not_found | Route not found |
Delete Route Environment Override
DELETE /v1/routes/:id/environments/:env
Removes the environment-specific override, reverting the route to its base configuration for that environment.
Path Parameters
| Parameter | Type | Description |
|---|
id | uuid | The route ID |
env | string | Environment name |
Response
{
"data": { "deleted": true },
"meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}
Errors
| Status | Type | Description |
|---|
| 404 | not_found | Route or environment config not found |