Audit logs provide a complete, immutable record of every configuration change made in your tenant — whether through the dashboard, the API, or automated workflows. Use them for compliance, debugging, and change tracking.
List Audit Logs
Returns a paginated list of audit log entries, newest first. You can filter by action type and resource type.
Query Parameters
| Parameter | Type | Default | Description |
|---|
page | integer | 1 | Page number |
per_page | integer | 20 | Items per page (max 100) |
action | string | — | Filter by action (e.g., create, update, delete) |
resource_type | string | — | Filter by resource type (e.g., route, secret, client, webhook, environment, api_key) |
Response
{
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"action": "create",
"resource_type": "route",
"resource_id": "rt-uuid-1",
"details": {
"name": "Payment Gateway",
"target_base_url": "https://api.stripe.com/v1"
},
"ip_address": "203.0.113.42",
"created_at": "2026-03-10T14:22:01.000Z"
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"action": "update",
"resource_type": "secret",
"resource_id": "sec-uuid-1",
"details": {
"field": "value",
"environment": "production"
},
"ip_address": "203.0.113.42",
"created_at": "2026-03-10T14:20:00.000Z"
}
],
"meta": {
"total": 487,
"page": 1,
"per_page": 20,
"total_pages": 25,
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
# List all audit logs
curl "https://api.knoxcall.com/v1/audit-logs" \
-H "Authorization: Bearer tk_live_abc123..."
# Filter by action and resource type
curl "https://api.knoxcall.com/v1/audit-logs?action=delete&resource_type=route" \
-H "Authorization: Bearer tk_live_abc123..."
Common Action Types
| Action | Description |
|---|
create | A resource was created |
update | A resource was modified |
delete | A resource was deleted |
enable | A resource was enabled |
disable | A resource was disabled |
revoke | An API key was revoked |
Common Resource Types
| Resource Type | Description |
|---|
route | API proxy route |
secret | Encrypted secret |
client | Authorized client |
webhook | Webhook configuration |
environment | Environment definition |
api_key | API key |
environment_config | Route environment override |
Audit logs are immutable and cannot be deleted. They are retained according to your subscription plan’s data retention policy.
