> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domesystems.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rollback Filter



## OpenAPI

````yaml POST /v1/guards/filters/{filter_id}/rollback
openapi: 3.0.3
info:
  title: Dome Platform API
  description: Connect and REST APIs for the Dome agent governance platform.
  version: 2.0.0
servers:
  - url: https://api.domesystems.ai
    description: Production
security: []
tags:
  - name: Agents
  - name: Authorization
  - name: Guards
  - name: Tools
  - name: Tool Catalog
  - name: Models
  - name: Model Pools
  - name: Quotas
  - name: Gateways
  - name: Webhooks
  - name: Audit
  - name: Workspaces
  - name: Access Control
  - name: Tenants
  - name: Platform Keys
  - name: Enrollment
  - name: Platform
  - name: Identity
paths:
  /v1/guards/filters/{filter_id}/rollback:
    post:
      tags:
        - Guards
      operationId: Management_RollbackFilter
      parameters:
        - name: filter_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RollbackFilterRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RollbackFilterResponse'
components:
  schemas:
    RollbackFilterRequest:
      type: object
      properties:
        workspace_id:
          type: string
        filter_id:
          type: string
        target_version_id:
          type: string
          description: The version to copy into a new active version.
    RollbackFilterResponse:
      type: object
      properties:
        filter:
          $ref: '#/components/schemas/Filter'
    Filter:
      type: object
      properties:
        id:
          type: string
        workspace_id:
          type: string
        name:
          type: string
        description:
          type: string
        config:
          allOf:
            - $ref: '#/components/schemas/FilterConfig'
          description: The active version's config.
        version:
          type: integer
          description: >-
            The active version number (1-based). 0 only if no version exists
            yet.
          format: int32
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        kind:
          type: integer
          description: |-
            The immutable content kind (text or json). Derived from the config's
             oneof arm at create time; never changes.
          format: enum
      description: >-
        Filter is the logical, workspace-scoped Filter entity: a stable id +
        mutable
         metadata (name, description), plus its ACTIVE version's config denormalized
         for the common "show me this filter" read. Version history is a separate
         FilterVersion list (ListFilterVersions). Editing deploys a new active version;
         assignments follow the active version.
    FilterConfig:
      type: object
      properties:
        text:
          $ref: '#/components/schemas/TextFilterConfig'
        json:
          $ref: '#/components/schemas/JSONFilterConfig'
      description: |-
        FilterConfig is one Filter entity version's full config. A Filter is
         either an ordered chain of text-compatible filtering components or an ordered
         chain of JSON-field-compatible components.
    TextFilterConfig:
      type: object
      properties:
        components:
          type: array
          items:
            $ref: '#/components/schemas/TextContentFilter'
      description: |-
        TextFilterConfig is an ordered chain of text-content filter components,
         applied in order and compiled into a CompositeFilter.
    JSONFilterConfig:
      type: object
      properties:
        components:
          type: array
          items:
            $ref: '#/components/schemas/JSONFieldFilter'
      description: >-
        JSONFilterConfig is an ordered chain of JSON-field filter components,
        applied
         in order and compiled into a composite JSON filter.
    TextContentFilter:
      type: object
      properties:
        action:
          type: integer
          format: enum
        matchers:
          type: array
          items:
            $ref: '#/components/schemas/Matcher'
      description: >-
        TextContentFilter scans assistant text and either redacts matched spans
        or
         blocks the response, per its matchers. It owns its action (whole-component:
         all its matchers share one FilterAction).
    JSONFieldFilter:
      type: object
      properties:
        field_actions:
          type: array
          items:
            $ref: '#/components/schemas/FieldAction'
      description: |-
        JSONFieldFilter describes a set of FieldActions: each identifies a
         field based on configuration, and performs a FilterAction on it.
         * REDACT rewrites the field value with a redaction sentinel.
         * BLOCK withholds the entire structured content.
         * OMIT removes the matched key/value pair.
         If multiple FieldActions for the same path are set, BLOCK > OMIT > REDACT.
    Matcher:
      type: object
      properties:
        substring:
          $ref: '#/components/schemas/SubstringMatcher'
        ssn:
          $ref: '#/components/schemas/SsnMatcher'
        credit_card:
          $ref: '#/components/schemas/CreditCardMatcher'
        phone:
          $ref: '#/components/schemas/PhoneMatcher'
        digits:
          $ref: '#/components/schemas/DigitsMatcher'
      description: Matcher is one match rule within a TextContentFilter.
    FieldAction:
      type: object
      properties:
        field:
          type: string
        action:
          type: string
        reason:
          type: string
    SubstringMatcher:
      type: object
      properties:
        value:
          type: string
      description: SubstringMatcher matches every occurrence of a fixed substring.
    SsnMatcher:
      type: object
      properties:
        delimiters:
          type: array
          items:
            type: integer
            format: enum
          description: Allowed separators between groups, empty => {space, hyphen}
      description: >-
        SsnMatcher matches US Social Security Number patterns, digit groups
        [3,2,4].
    CreditCardMatcher:
      type: object
      properties:
        delimiters:
          type: array
          items:
            type: integer
            format: enum
        require_luhn:
          type: boolean
        min_digits:
          type: integer
          format: uint32
        max_digits:
          type: integer
          format: uint32
      description: >-
        CreditCardMatcher matches 13–19 digit card numbers, optionally validated
        by
         the Luhn checksum.
    PhoneMatcher:
      type: object
      properties:
        delimiters:
          type: array
          items:
            type: integer
            format: enum
        group_sizes:
          type: array
          items:
            type: integer
            format: uint32
        require_country_code:
          type: boolean
        require_parens:
          type: boolean
      description: PhoneMatcher matches telephone numbers, default US groups [3,3,4].
    DigitsMatcher:
      type: object
      properties:
        digits:
          type: integer
          format: uint32
        group_sizes:
          type: array
          items:
            type: integer
            format: uint32
        delimiters:
          type: array
          items:
            type: integer
            format: enum
      description: |-
        DigitsMatcher matches an arbitrary N-digit number, optionally split into
         fixed-size groups.

````