Interlays API

Interlays are Eve-managed native protocol listeners. They give applications a stable Eve address for supported database and cache traffic while Eve applies endpoint identity, RBAC, command policy, traffic masking, traffic mirroring, and telemetry before the backend receives a request.

Use this API to create, configure, start, stop, inspect, and remove a listener. It is focused on listener lifecycle and runtime configuration.

What An Interlay Manages

  • A native listener bound to one primary endpoint.
  • TLS, listener configuration, and endpoint identity context.
  • Supported command-policy and audit settings.
  • Traffic Masking before backend egress.
  • Traffic Mirroring to secondary endpoints without changing the primary client response.
  • Listener lifecycle and safe time-series analysis.

Route Map

MethodPathPurpose
GET/api/v1/interlaysList interlays in the current organization.
POST/api/v1/interlaysCreate an interlay listener.
GET/api/v1/interlays/updatedList interlays with update-state information.
GET/api/v1/interlays/{interlay}Read one interlay by ID or UUID.
PATCH/api/v1/interlays/{interlay}Update listener configuration.
DELETE/api/v1/interlays/{interlay}Remove an interlay.
POST/api/v1/interlays/{interlay}/startStart the managed listener.
POST/api/v1/interlays/{interlay}/stopStop the managed listener.
GET/api/v1/interlays/{interlay}/analysis/timeseriesRead listener analysis time-series data.

Create An Interlay

Create an interlay with an organization endpoint and the listener settings appropriate for its endpoint kind.

http
POST /api/v1/interlays
Authorization: Bearer <token>
Content-Type: application/json
json
{
  "id": "orders-cache",
  "endpoint": "550e8400-e29b-41d4-a716-446655440001",
  "port": 6366,
  "settings": {},
  "tls": false
}

The endpoint must be reachable through the requesting organization, and callers need permission to manage the listener and its endpoint. The response reports whether the listener is running; use the lifecycle routes to stop or restart it as needed.

Configure Important Traffic Controls

Masking and mirroring are independent, additive settings on an interlay. Configure only settings supported by the endpoint processor and backend profile:

json
{
  "settings": {
    "mirror": {
      "enabled": true,
      "mode": "mirror",
      "mirror_endpoint_uuids": ["7a2e4f1b-0000-0000-0000-000000000000"],
      "mirror_reads": true,
      "mirror_writes": false,
      "sample_ratio": 0.1,
      "max_in_flight_per_mirror": 128
    },
    "masking": {
      "request_terms": []
    }
  }
}

Use the dedicated feature guides for rule semantics, supported request surfaces, failure behavior, and operational guidance:

Operate The Listener

Use the lifecycle routes after provisioning or configuration changes:

http
POST /api/v1/interlays/{interlay}/start
POST /api/v1/interlays/{interlay}/stop
GET /api/v1/interlays/{interlay}/analysis/timeseries

Review endpoint health, RBAC, TLS, masking, and mirror capacity before directing production clients to a listener. The analysis route provides listener-level evidence without exposing backend credentials.

Last updated: July 10, 2026