Interceptors

About Interceptors

You can add an additional logic into the processing of every request and response for models and apps, enabling PII obfuscation, guardrails, safety checks, and beyond. This is achieved through the integration of pluggable components known as Interceptors.

Refer to Interceptors to learn more.

Interceptors List

In Interceptors, you can find, manage and add interceptors.

Interceptors Grid

Field	Definition
Display Name	A user-friendly name of the interceptor (e.g. "PII Information Remover").
Description	A brief summary of what this interceptor does and any parameters it uses (e.g. BLACKLIST=bar or Logs request/response payloads).
ID	A unique identifier for the interceptor (e.g. reject-blacklisted-words, audit-logger). This key is used when you attach it to a Model or Application.
Source Type	Can be one of the following options: Interceptor Template, Interceptor Container, External Endpoint.
Source	Exact Interceptor Template Id, Interceptor Container Id or Completion Endpoint of the interceptor.
Author	Contains e-mail of interceptor's author.

Create

1. Click + Create to invoke the Create Interceptor modal.
2. Define interceptor's parameters:

Column	Definition & Use
ID	A unique identifier for the interceptor (e.g. reject-blacklisted-words, audit-logger). This key is used when you attach it to a Model or Application.
Display Name	A user-friendly name of the interceptor (e.g. "PII Information Remover").
Description	A brief summary of what this interceptor does and any parameters it uses (e.g. BLACKLIST=bar or Logs request/response payloads).

3. Once all required fields are filled, click Create. The dialog closes and the new interceptor configuration screen is opened. Once added, a new entry appears in the Interceptors listing. It may take some time for the changes to take effect after saving.

Configuration

Top Bar Controls

• Delete: Permanently removes the selected interceptor.
• JSON Editor (Toggle): Switch between the form-based UI and raw JSON view of the interceptor’s configuration. Use JSON mode for copy-paste or advanced edits.

Properties

In the Properties tab, you can define metadata and execution endpoints for Interceptors.

Field	Required	Definition & Use Case
ID	Yes	A unique key under interceptors in DIAL Core’s dynamic settings (e.g. data-clustering, support-bot).
Updated Time	-	Date and time when the interceptor's configuration was last updated.
Creation Time	-	Date and time when the interceptor's configuration was created.
Display Name	No	A user-friendly name of the interceptor (e.g. "PII Information Remover").
Description	No	A free-text summary of the interceptor’s behavior and any configuration parameters (e.g. BLACKLIST={"foo","bar"}). Helps to identify the interceptor and its purpose.
Maintainer	No	Field used to specify the responsible person or team overseeing the interceptor and its configuration.
Forward Auth Token	No	Specify whether to forward an Auth Token to your interceptor's endpoint. Use this when your interceptor service requires its own authentication.
Source Type	Yes	Can be one of the following options: Interceptor Template, Interceptor Container, External Endpoint.
Completion Endpoint	Conditional	Required if Source Type is 'External Endpoint'. The URL of the interceptor service. This URL is used to handle requests and responses for the interceptor.
Configuration Endpoint	Optional	Optional, appears only if Source Type is 'External Endpoint'.The URL to fetch dynamic interceptor-specific settings.
Interceptor Template	Conditional	Required if Source Type is 'Interceptor Template'. Specific template used by interceptor. See more details here.
Interceptor Container	Conditional	Required if Source Type is 'Interceptor Container'. Specific container used by interceptor.

Entities

In the Entities tab, you can see to which Models and Applications this interceptor is currently attached. By binding interceptors here, you control exactly which AI endpoints (and in what order) will invoke your custom pre- or post-processing logic.

Column	Definition
ID	A unique identifier of the Application or Model.
Display Name	A user-friendly name of the Application/Model (e.g. "Data Clustering Application").
Description	Provides a brief summary of the application or model purpose.
Type	A type of the entity using the given interceptor: Model, Application.

Add

1. Click + Add (top-right of the Entities Grid).
2. Select one or more apps/models in the modal.
3. Confirm to insert them into the table.

Remove

1. Click the actions menu in the entity's line.
2. Choose Remove in the menu.

JSON Editor

For advanced scenarios of bulk updates, copy/paste between environments, or tweaking settings not exposed in the form UI—you can switch to the JSON Editor in any interceptor configuration page.

Switching to the JSON Editor

1. Navigate to Entities → Interceptors, then select the interceptor you want to edit.
2. Click the JSON Editor toggle (top-right). The UI reveals the raw JSON.

TIP: You can switch between UI and JSON only if there are no unsaved changes.