Guards
Inspect, redact, and constrain content on tool and model connections
Guards inspect request and response content on tool and model connections. Filters can redact, omit, or block matching text. Validators block tool traffic when structured checks fail.
Refer to Guards for Filters, Validators, and assignment. Editing a Filter or Validator deploys a new active version; assigned connections pick it up on the next gateway sync. All tools require workspace context.
Filters
dome_guards_list_filters
List the workspace's Filters, each with its active version and config.
| Parameter | Type | Required | Description |
|---|---|---|---|
| — | — | — | No parameters |
dome_guards_get_filter
Fetch one Filter's active version and config.
| Parameter | Type | Required | Description |
|---|---|---|---|
filter | string | Yes | Filter name or UUID |
dome_guards_list_filter_versions
List a Filter's version history, newest first. Rollback-produced versions cite their source version id.
| Parameter | Type | Required | Description |
|---|---|---|---|
filter | string | Yes | Filter name or UUID |
dome_guards_create_filter
Create a Filter — its first active version. Supply the config via the convenience params (text-only) or config_json (any kind).
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Filter name (workspace-scoped) |
description | string | No | One-line description |
redact_substrings | array of string | No | Substrings to redact in matched responses (text) |
block_substrings | array of string | No | Substrings that block the response on a match (text) |
redact_ssn | bool | No | Redact US SSN patterns (text) |
block_ssn | bool | No | Block the response on an SSN match (text) |
config_json | string | For JSON Filters, or full-fidelity text | Protojson dome.guards.v1.FilterConfig. Overrides the convenience params. |
The convenience params build at most two components — a redact component and a block component, redact ordered first — and only produce text Filters. Pass config_json to author a JSON Filter or a multi-component text chain.
JSON Filter config
{
"json": {
"components": [
{
"field_actions": [
{ "matcher": { "key": "ssn" }, "action": "FILTER_ACTION_OMIT" },
{ "matcher": { "key": "email" }, "action": "FILTER_ACTION_REDACT" },
{ "matcher": { "key": "card" }, "action": "FILTER_ACTION_BLOCK" }
]
}
]
}
}BLOCK withholds the whole message. OMIT removes the key and value. REDACT rewrites the value with a redaction sentinel. When multiple actions target the same key: BLOCK > OMIT > REDACT.
dome_guards_update_filter
Edit metadata in place (new_name, description), or deploy a new active version by passing any config param. History is preserved.
| Parameter | Type | Required | Description |
|---|---|---|---|
filter | string | Yes | Filter name or UUID |
new_name | string | No | New name for the logical Filter |
description | string | No | New description |
redact_substrings / block_substrings / redact_ssn / block_ssn / config_json | — | No | Any config param deploys a new active version |
Pass at least one of new_name, description, or a config param.
dome_guards_rollback_filter
Roll a Filter back to an earlier version. The target version's config is copied forward into a new active version.
| Parameter | Type | Required | Description |
|---|---|---|---|
filter | string | Yes | Filter name or UUID |
to_version | number | Yes | Version number to roll back to |
dome_guards_delete_filter
Hard-delete a Filter and its connection assignments.
| Parameter | Type | Required | Description |
|---|---|---|---|
filter | string | Yes | Filter name or UUID |
Filter assignment
dome_models_guards_filters_list
List the text Filters assigned to a model connection, in chain order, grouped by direction.
| Parameter | Type | Required | Description |
|---|---|---|---|
connection | string | Yes | Model connection name |
dome_models_guards_filters_set
Replace the entire ordered Filter chain for one direction on a model connection. Only text-kind Filters may be assigned.
response filters completions the agent receives. request filters the outbound prompt before dispatch to the model provider — a match can redact or block the call.
| Parameter | Type | Required | Description |
|---|---|---|---|
connection | string | Yes | Model connection name |
direction | string | Yes | response or request |
filters | array of string | Yes | Ordered Filter names or UUIDs; empty clears the chain |
dome_tools_guards_filters_list
List the JSON Filters assigned to an MCP server (tool) connection, in chain order, grouped by direction.
| Parameter | Type | Required | Description |
|---|---|---|---|
connection | string | Yes | MCP server connection name |
dome_tools_guards_filters_set
Replace the entire ordered Filter chain for one direction on a tool connection. Only json-kind Filters may be assigned.
request filters run over tool arguments before the call reaches the upstream MCP server — matched fields are redacted or omitted, or the whole call is blocked. response filters run over the tool result before the agent sees it.
| Parameter | Type | Required | Description |
|---|---|---|---|
connection | string | Yes | MCP server connection name |
direction | string | Yes | response or request |
filters | array of string | Yes | Ordered Filter names or UUIDs; empty clears the chain |
Validators
dome_guards_list_validators
List the workspace's Validators, each with its active version and kind.
| Parameter | Type | Required | Description |
|---|---|---|---|
| — | — | — | No parameters |
dome_guards_get_validator
Fetch one Validator's active version and config.
| Parameter | Type | Required | Description |
|---|---|---|---|
validator | string | Yes | Validator name or UUID |
dome_guards_list_validator_versions
List a Validator's version history, newest first.
| Parameter | Type | Required | Description |
|---|---|---|---|
validator | string | Yes | Validator name or UUID |
dome_guards_create_validator
Create a Validator — its first active version.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Validator name (workspace-scoped) |
config_json | string | Yes | Protojson dome.guards.v1.ValidatorConfig |
description | string | No | One-line description |
Kind (tool_request or tool_response) is derived from the config arm and is immutable.
Example config
{
"toolRequest": {
"json": {
"requiredPaths": ["user_id"],
"maximumSize": 4096
}
}
}dome_guards_update_validator
Edit metadata in place, or pass config_json to deploy a new active version.
| Parameter | Type | Required | Description |
|---|---|---|---|
validator | string | Yes | Validator name or UUID |
new_name | string | No | New name |
description | string | No | New description |
config_json | string | No | Deploy a new active version |
Pass at least one of new_name, description, or config_json.
dome_guards_rollback_validator
Roll a Validator back to an earlier version.
| Parameter | Type | Required | Description |
|---|---|---|---|
validator | string | Yes | Validator name or UUID |
to_version | number | Yes | Version number to roll back to |
dome_guards_delete_validator
Hard-delete a Validator and its connection assignments.
| Parameter | Type | Required | Description |
|---|---|---|---|
validator | string | Yes | Validator name or UUID |
Validator assignment
dome_tools_guards_validators_list
List Validators assigned to a tool connection, grouped by direction.
| Parameter | Type | Required | Description |
|---|---|---|---|
connection | string | Yes | MCP server connection name |
dome_tools_guards_validators_add
Attach Validators to one direction on a tool connection. Response Validators are MCP-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
connection | string | Yes | MCP server connection name |
direction | string | Yes | request or response |
validators | array of string | Yes | Validator names or UUIDs |
dome_tools_guards_validators_remove
Detach Validators from one direction on a tool connection.
| Parameter | Type | Required | Description |
|---|---|---|---|
connection | string | Yes | MCP server connection name |
direction | string | Yes | request or response |
validators | array of string | Yes | Validator names or UUIDs |
Next steps
Create and assign Filters and Validators from Govern. Catalogs cover windows, path syntax, and Validator conditions:
- Configure Guards
- Guards concept
- Guards reference